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Foreword 



Welcome to the world of microcomputers opened to you by your Motorola® 
MC68000 microprocessor. Welcome also to the world of application software acces- 
sible through your Digital Research CP/M-68K™ operating system. Digital Research 
designed CP/M-68K especially for the Motorola MC68000 microprocessor that is 
the heart of your computer. 

What CP/M-68K Does for You 

CP/M-68K manages and supervises your computer's resources, including memory 
and disk storage, the console (screen and keyboard), printer, and communications 
devices. It also manages information stored magnetically on disks by grouping this 
information into files of programs or data. CP/M-68K can copy files from a disk to 
your computer's memory, or to a peripheral device such as a printer. To do this, 
CP/M-68K places various programs in memory and executes them in response to 
commands you enter at your console. 

Once in memory, a program runs through a set of steps that instruct your com- 
puter to perform a certain task. You can use CP/M-68K to create your own pro- 
grams, or you can choose from the wide variety of CP/M-68K application programs 
that entertain you, educate you, and help you solve commercial and scientific problems. 

What You Need to Run CP/M-68K on Your Computer 

The CP/M-68K operating system runs on the Motorola MC68000 microprocessor. 
You need that microprocessor, a console device (generally a keyboard and display 
device such as a CRT screen), and at least one floppy disk drive. To use all the 
capabilities of CP/M-68K, you should have two disk drives. At least one should be a 
single density floppy drive compatible with the IBM 3740 diskette controller, because 
CP/M-68K and most CP/M® applications are distributed on floppy disks suitable for 
this environment. 

CP/M-68K and its utility programs are distributed on five floppy disks. The system 
disk, labeled 1 of 5, contains the operating system and the most commonly used utility 
programs. The second disk, labeled 2 of 5, contains additional utilities. Disks 3, 4, and 
5 contain still more utilities, the C compiler, the C language library, files which can 
be used to build versions of C/M-68K adapted to custom hardware environments, and 
sample Basic Input/Output Systems. 
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How to Use CP/M-68K Documentation 

The CP/M-68K documentation set includes four manuals: 

■ CP/M-68K Operating System User's Guide 

■ CP/M-68K Operating System Programmer's Guide 

■ CP/M-68K Operating System System Guide 

■ C Language Programming Guide for CP/M-68K 

The CP/M-68K Operating System User's Guide introduces you to the CP/M-68K 
operating system and tells you how to use it. The User's Guide assumes that the 
version of CP/M-68K on your distribution disk is ready to run on your computer. 
To use this manual, you must be familiar with the parts of your computer, you must 
know how to set it up and turn it on, and you must know how to handle, insert, 
and store disks. However, you do not need a great deal of experience with computers. 

The CP/M-68K Operating System Programmer's Guide presents information for 
application programmers who are creating or adapting programs to run under 
CP/M-68K. The Programmer's Guide includes information on the CP/M-68K assem- 
bler and debugger that experienced programmers use to create new CP/M-68K 
programs. 

The CP/M-68K Operating System System Guide describes the procedures required 
to adapt CP/M-68K for a custom hardware environment. 

C Language Programming Guide for 68K contains information for programmers 
who wish to use the C compiler and C language library included with CP/M-68K. 

How the User's Guide is Organized 

This guide begins with simple examples, proceeds with basic concepts, then pre- 
sents a detailed reference section on commands. The first four sections describe 
CP/M-68K operation for the first-time user. 

Section 1 introduces CP/M-68K and tells you how to start the operating system, 
enter commands, edit the command line, and create a back-up copy of your distri- 
bution disks. Section 2 discusses files, disks, and drives. Section 3 describes how you 
can use CP/M-68K to manage your printer and console. 
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Section 4 develops the concepts you need to use CP/M-68K commands. If you are 
new to CP/M, read the first four sections carefully to get a general understanding of 
how to use CP/M-68K before you proceed to the specific command descriptions. 

Section 5 provides detailed information on each CP/M-68K utility program, arranged 
alphabetically for easy reference. Section 6 tells you how to use ED, the CP/M-68K 
file editor. With ED, you can create and edit program, text, and data files. 

Appendix A lists the messages CP/M-68K displays when it encounters special con- 
ditions, and describes corrective action where necessary. Appendix B provides an 
ASCII to hexadecimal conversion table. Appendix C lists the filetypes associated with 
CP/M-68K. Appendix D lists and defines the CP/M-68K control characters. Appen- 
dix E provides a simple glossary of commonly used computer terms. 

If you are new to computers, you might find some of the topics a bit difficult to 
understand at first. Learning to use your computer is a challenge, and we hope you 
will find it fun. This book proceeds step-by-step so that you can quickly proceed 
from opening your new system disk package to using CP/M-68K's powerful facilities. 
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Section 1 
Introduction to CP/M-68K 



This section tells you how to start CP/M-68K, how to enter a command and edit 
the command line, and how to make a back-up copy of your CP/M-68K distribution 
disks. 



1.1 How to Start CP/M-68K 

Starting or loading CP/M-68K means reading a copy of the operating system from 
your CP/M-68K system disk (1 of 5 of your distribution disks) into your computer's 
memory. This is called a boot or cold start. Because the boot process varies from 
computer to computer, you must follow the manufacturer's instructions for the com- 
puter you use. The next two paragraphs describe a typical, but not universal, booting 
process. 

First, be sure your computer's power is on. Next, insert the CP/M-68K system disk 
into your initial drive. In this section, assume that the initial drive is A and the disk 
is removable. Close the drive door. Then, press the RESET or RESTART button. 
This automatically loads CP/M-68K into memory. 

If you want to restart CP/M-68K at some point after the initial loading of the 
system, first make sure your CP/M-68K system disk is in your initial drive, then press 
the RESET or RESTART button. This is called system reset. It has the same effect as 
pressing RESET or RESTART when you first power up your computer. If you do a 
system reset after you have powered up, any data that is in your computer's memory 
prior to the system reset is erased. This means that any data that is not stored on a 
disk is lost. 

After CP/M-68K is loaded into memory, the following message is displayed on 
your screen: 

CP/M-68K Version V.V 

Copy ri 3ht < c) 1983 Digital Research Inc. 
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The version number, represented above by V.V, tells you the version of CP/M-68K 
that you own. After this display, the following two-character message appears on 
your screen: 

A> 

This is the CP/M-68K system prompt. The system prompt tells you that 
CP/M-68K is ready to read a command from your keyboard. In this example, the 
prompt also tells you that drive A is your default drive. This means that until you 
tell CP/M-68K to do otherwise, it looks for program and data files on the disk in 
drive A. 

1.2 The Command Line 

CP/M-68K performs certain tasks according to specific commands that you type at 
your keyboard. A CP/M-68K command line is composed of a command keyword, an 
optional command tail, and a RETURN keystroke. The command keyword identifies 
a command (program) to be executed. The command tail can contain extra informa- 
tion for the command, such as a filename or parameters. To end the command line, 
you must press the RETURN key. Note that the RETURN key can be marked 
ENTER, RETURN, CR, or something similar on your keyboard. In this guide, 
RETURN signifies the RETURN key. 

As you type characters at the keyboard, they appear on your screen. The single- 
character position indicator, called the cursor, moves to the right as you type char- 
acters. If you make a typing mistake, press either the BACKSPACE key (if your 
keyboard has one) or CTRL-H to move the cursor to the left and correct the error. 
CTRL is the abbreviation for the CONTROL key. To type a control character, hold 
down the CTRL key and press the required letter key. For example, to move the 
cursor to the left, hold down CTRL and press the H key. 

You can type the keyword and command tail in any combination of upper-case 
and lower-case letters. CP/M-68K treats all letters in the command line as upper- 
case. 

Generally, you type a command line directly after the system prompt. However, 
CP/M-68K does allow spaces between the prompt and the command keyword. 
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Let's use one command to demonstrate how CP/M-68K reads command lines. The 
DIR command tells CP/M-68K to give you a directory of the names of disk files on 
your screen, while the DIRS command displays only the system files. Type the DIRS 
keyword after the system prompt, omit the command tail, and press RETURN. 

A>DI/?S 

CP/M-68K responds to this command by writing the names of those files that are 
stored in the default storage area. For discussion of storage areas, refer to Section 2.4. 
For example, if you have your CP/M-68K system disk in the default drive A, these 
filenames, among others, appear on your screen: 

STAT G8K 

PIP B8K 

CP/M-68K takes the command keyword exactly as you type it and compares your 
input to executable program files in the CP/M-68K directory. If the command key- 
word matches a program file in the directory, CP/M-68K executes that program. If 
the first word you typed does not match any file in the directory, CP/M-68K echoes 
this unmatchable command keyword and puts a question mark after it. For example, 
if you mistype the DIRS command, CP/M-68K responds 

A>0J/?S 
DJRS? 

to tell you that it cannot find the command keyword. To correct simple typing errors, 
use the BACKSPACE key, or hold down the CTRL key and press H to move the 
cursor to the left. You cannot correct typing errors after you press the RETURN key. 
The command must then be typed correctly in its entirety. CP/M-68K supports other 
control characters that help you edit command lines efficiently. Section 3 tells how 
to use control characters to edit command lines and other information you enter at 
your console. 

DIRS accepts a filename as a command tail. You can use DIRS with a filename to 
see if a specific file is on the disk. For example, to check that the transient utility 
program COPY.68K is on your system disk, type 

f\>DIRS C0PY.B8K 
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CP/M-68K performs this task by displaying either the name of the file you specified, 
or the message, No File. 

Be sure to type at least one space after DIRS to separate the command keyword 
from the command tail. If you do not, CP/M-68K responds as shown. 

b>DIRSC0PY,68K 
DIRSC0PY.G8K? 



1.3 Why You Should Back Up Your Files 

Human or computer errors sometimes destroy valuable programs or data files. By 
mistyping a command, for example, you could accidentally erase a program that you 
just created or a data file that has been months in the making. A similar disaster 
could result from an electronic component failure. 

Data processing professionals avoid losing programs and data by making copies of 
valuable files. Always make a working copy of any new program you purchase and 
save the original. If the program is accidentally erased from the working copy, you 
can easily restore it from the original. 

It is also wise to make frequent copies of new programs or data files as you 
develop them. The frequency of making copies varies with each programmer. As a 
general rule, make a copy at the point where it takes ten to twenty times longer to 
reenter the information than it takes to make the copy. 

Note: if you suspect a hardware problem has interfered with your copying, do not 
use your valuable backup disk to restart or continue the copy process. Hardware 
problems have an even greater potential for harm to your disks than software prob- 
lems do. If you need to locate a hardware problem, please use non-critical disks. 

So far, we have not discussed any commands that change information recorded on 
your CP/M-68K system disk. Before we do, let's make a few working copies of the 
your distribution disks. 
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1.4 How to Make Copies of Your CP/M-68K Disks 

To back up your CP/M-68K disks, you need several floppy disks. The back-up 
disks can be factory-fresh or used. You might want to format new disks or reformat 
used disks with the disk formatting program that accompanies your particular com- 
puter. If the disks are used, make sure that there are no files on the disk that you 
want to save. 

If your computer's manufacturer has provided a special program to copy disks, 
you might use that program to make back-ups of your distribution disks. Otherwise, 
you can use the COPY utility program that comes with your set of CP/M-68K 
distribution disks. COPY is a track-by-track disk copying program that can copy the 
operating system loader and utility programs from your system disk. COPY creates a 
complete and exact copy of your system disk. 

To use the COPY utility, simply type COPY and press the RETURN key. The 
following message comes on the screen: 

COPY VER 1.1 

followed by a mode menu: 

MODE FUNCTION 

ALL Copy the whole disk 

BOOT Copy the boot tracKs only 

FILES Copy the non-boot tracks 

END End the program 
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Once you have selected your mode, type it in and press RETURN. The following 
prompt appears on the screen: 

Enter SOURCE drive: _ 

You must then type a drive letter from A to P and press RETURN. The program 
then prompts you to 

Enter DESTINATION drive: _ 

Again, you must select a drive letter, and press RETURN. Then the program gives 
you a chance to abort the process by prompting: 

< A C to ABORT) 

RETURN to copy <mode> from (source) to < dest inat i on > 

The program gives you a chance to review what you have selected before proceeding. 
If you still want to proceed, press the RETURN key. If not, hold down the control 
key while pressing C and the process will be terminated. For an expanded treatment 
of the COPY utility, see Section 5, "Command Summary." 



End of Section 1 
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Section 2 
Files, Disks, and Drives 



CP/M-68K's most important task is to access and maintain files on your disks. 
With CP/M-68K you can create, read, write, copy, and erase disk files. This section 
tells you what a file is, how to create, name, and access a file, and how files are 
stored on your disks. It also tells how to change disks and change the default drive. 



2.1 What is a File? 

A CP/M-68K file is a collection of related information stored on a disk. Every file 
on a given disk must have a unique name because CP/M-68K uses that name to 
access that file. A directory is also stored on each disk. The directory contains a list 
of the files stored on that disk and the locations of each file on the disk. 

In general, there are two kinds of files: program (command) files and data files. A 
program file is an executable file, a series of instructions the computer can follow 
step-by-step. A data file is usually a collection of information: a list of names and 
addresses, the inventory of a store, the accounting records of a business, the text of 
a document, or similar related information. For example, your computer cannot 
execute names and addresses, but it can execute a program that prints names and 
addresses on mailing labels. 

A data file can also contain the source code for a program. Generally, a program 
source file must be processed by an assembler or compiler before it becomes a pro- 
gram file. In most cases, an executing program processes a data file. However, there 
are times when an executing program processes a program file. For example, the 
copy program PIP can copy one or more program files. 
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2.2 How are Files Created? 

There are many ways to create a file. You can create a file by copying an existing 
file to a new location, perhaps renaming it in the process. Under CP/M-68K, you can 
use the PIP command to copy and rename files. A second way to create a file is to 
use a text editor. The CP/M-68K text editor ED, described in Section 6, can create a 
file and assign it the name you specify. Finally, some programs such as AS68™ create 
output files as they process input files. 



2.3 Naming Files — What's in a Name? 

CP/M-68K identifies every file by its unique file specification. The simplest kind of 
file specification is a one- to eight-character filename, such as: 

MYFILE 

A file specification can have up to three parts: a drive specifier, a filename, and a 
filetype. 

The drive specifier is a single letter (A-P) followed by a colon. Each drive in your 
system is assigned a letter. When you include a drive specifier as part of the file 
specification, you are telling CP/M-68K that the file is stored on the disk currently in 
that drive. For example, if you enter 

B:MYFILE 

CP/M-68K looks in drive B for the file MYFILE. 

The filename can be from one to eight characters. When you make up a filename, 
try to let the name tell you something about what the file contains. For example, if 
you have a list of customer names for your business, you could name the file 

CUSTOMER 

so that the name is eight or fewer characters, and gives you some idea of what is in 
the file. 



m DIGITAL RESEARCH™ 



2-2 



CP/M-68K User's Guide 2.3 Naming Files 

As you begin to use your computer with CP/M-68K, you will find that files fall 
naturally into categories. To help you identify files belonging to the same category, 
CP/M-68K allows you to add an optional one- to three-character extension, called a 
filetype, to the filename. When you add a filetype to the filename, separate the filetype 
from the filename with a period. Try to use three letters that tell something about 
the file's category. For example, you could add the following filetype to the file that 
contains a list of customer names: 

CUSTOMER. NAM 

When CP/M-68K displays file specifications in response to a directory or DIR com- 
mand, it adds blanks to short filenames so that you can compare filetypes quickly. 

The program files that CP/M-68K loads into memory from a disk have different 
filetypes, but are in the category of 68000 and equivalent programs that run with 
CP/M-68K. The filetypes .68K and .REL identify this category of executable programs. 

We recommend that you create file specifications from letters and numbers. You 
must not use the following characters in filenames or filetypes because they have 
special meanings for CP/M-68K: 

<> = ,!|*?&/[]().:; + -\ 

A complete file specification containing all possible elements consists of a drive 
specification, a primary filename, and a filetype, each separated from the other by its 
appropriate delimiter, as shown in the following example: 

A: DOCUMENT. LAN 



2.4 Accessing Files — Do You Have the Correct Drive? 

When you type a file specification in a command tail without a drive specifier, the 
built-in or transient utility looks for the file in the drive named by the system prompt, 
called the default drive. For example, if you type the command 

(\>DIR C0PY.68K 
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DIR looks in the directory of the disk in drive A for COPY. 6 8 K. If you have another 
drive, B for example, you need a way to tell CP/M-68K to access the disk in drive B 
instead. For this reason, CP/M-68K lets you precede a filename with a drive specifier. 
For example, in response to the command 

A>DI/? B:MYFILE.LIB 

CP/M-68K looks for the file MYFILE.LIB in the directory of the disk in drive B. 
When you give a command to CP/M-68K, you should note which disk is in the 
default drive. Many application programs require that the data files they access be 
stored in the default drive. 

You can also precede a program filename with a drive specifier, even if you use the 
program filename as a command keyword. For example, if you type the following 
command: 

A>S:PIP 

CP/M-68K looks in the directory of the disk in drive B for the file PIP.68K. If 
CP/M-68K finds PIP on drive B, under user 0, it loads PIP into memory and executes 
it. 

If you need to access many files on the same drive, you might find it convenient to 
change the default drive so that you do not need to enter a drive specifier repeatedly. 
To change the default drive, simply enter the drive specifier next to the system 
prompt. In response, CP/M-68K changes the system prompt to display the new default 
drive: 

A>S; 
B> 

Because the drive specifier is part of a file's file specification, moving a disk to a 
different drive changes the file specifications of the files on that disk. Keep this in 
mind when moving disks from one drive to another. 

Section 4 presents more information on how CP/M-68K locates program and data 
files. 
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2.5 Accessing Files — Do You Have the Correct User Number? 

CP/M-68K further identifies all files by assigning each file a user number, in the 
range from to 15, when the file is created. The user number for each file is recorded 
in the disk directory. User numbers allow you to separate your files into sixteen file 
groups. User numbers are particularly useful for organizing hard disk space. 

When you use a CP/M-68K utility to create a file, the file is assigned to the current 
user number, unless you use PIP to copy the file to another user number. You can 
determine the current user number by looking at the system prompt. 

4 A > User number 4, drive A 
A > User number 0, drive A 

2B > User number 2, drive B 

The user number always precedes the drive identifier in the system prompt. User 0, 
however, is the default user number and is not displayed in the prompt. 

You can use the built-in command USER to change the current user number. 

A>L/SE/? 3 
3A> 

Most commands can access only those files that have the current user number. For 
example, if the current user number is 7, a DIR command displays only the files that 
were created under user number 7. However, if an executable program file or a 
SUBMIT file resides in user 0, the file can be accessed from any user number, in case 
it does not already exist in the current user area. 



2.6 Accessing More Than One File 

Certain CP/M-68K built-in and transient utilities can select and process several 
files when special wildcard characters are included in the filename or filetype. A file 
specification containing wildcards can refer to more than one file because it gives 
CP/M-68K a pattern to match. CP/M-68K searches the disk directory and selects any 
file whose filename or filetype matches the pattern. 
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The two wildcard characters are ?, which matches any single letter in the same 
position, and *, which matches any character at that position, and any other charac- 
ters remaining in the filename or filetype. The following list presents the rules for 
using wildcards. 

■ A ? matches any character in a name, including a space character. 

■ An * must be the last, or only, character in the filename or filetype. 
CP/M-68K internally replaces an * with ? characters to the end of the file- 
name or filetype. 

■ When the filename to match is shorter than eight characters, CP/M-68K treats 
the name as if it ends with spaces. 

■ When the filetype to match is shorter than three characters, CP/M-68K treats 
the filetype as if it ends with spaces. 

Suppose, for example, you have a disk that contains the following six files: 

A.E8K > AA.B8K t AAA.S8K * B.68K * A.REL t and B.REL 

The following wildcard specifications match all, or a portion of, the preceding files: 

* is treated as ????????.??? 
?????? . ??? matches all six names 
B8K is treated as ????????.68K 

"?????? ( GBK matches the first four names 

BBK matches A.68K and B.68K 

* is treated as ?.??? 
??? matches A.68K, B.68K, A.REL, and B.REL 

A ? ♦ B 8 K matches A.68K and AA.68K 

A*,B8K is treated as A???????.68K 

A 



otjooo 1 ; 



. B8K matches A.68K, AA.68K, and AAA.68K 



Remember that CP/M-68K uses wildcard patterns only while searching a disk 
directory, and therefore wildcards are valid only in filenames and filetypes. You 
cannot use a wildcard character in a drive specifier. 
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2.7 File Attributes 

When you create a file, CP/M-68K gives it two attributes: DIR (for DIRectory) 
and R/W (for Read- Write). Through the STAT command, you can change these 
attributes from DIR to SYS (for SYStem) and from R/W to R/O (for Read-Only). 

DIR and SYS attributes control whether CP/M-68K displays the file's name in 
response to a DIR command or DIRS command. DIR displays only the file specifica- 
tions having the DIR attribute; DIRS displays only the file specifications having the 
SYS attribute. 

The second file attribute can be set to either R/W (Read- Write) or R/O (Read- 
Only). If a file is marked R/O, any attempt to write data to that file produces a Read- 
Only error message. Therefore, you can use the R/O attribute to protect important 
files. A file with the R/W attribute can be read or written to at any time, unless you 
inadvertently switch disks during execution of a program. 



2.8 How are Files Stored on a Disk? 

CP/M-68K records the filename, filetype, user number, and attributes of each file 
in a special area of the disk called the directory. In the directory, CP/M-68K also 
records which parts of the disk belong to which file. You can use the STAT com- 
mand to determine the number of entries in your directory. 

CP/M-68K allocates directory and storage space for a file as records are added to 
the file. When you erase a file, CP/M-68K reclaims storage in two ways: it makes the 
file's directory space available to catalog a different file, and it frees the file's storage 
space for later use. This handling of storage and directory space, called dynamic file 
allocation, is a powerful feature of CP/M-68K. You do not have to tell CP/M-68K 
how big your file will become, because it automatically allocates more storage for a 
file as needed, and releases the storage for reallocation when the file is erased. Use 
the STAT command to determine how much space remains on the disk. 
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2.9 Changing Floppy Disks 

CP/M-68K cannot, of course, do anything to a file unless the disk that holds the 
file is inserted into a drive and the drive is ready. When a disk is in a drive, it is on- 
line and CP/M-68K can access its directory and files. 

At some time, you will need to take a disk out of a drive and insert another that 
contains different files. You can replace an on-line disk whenever you see the system 
prompt at your console. This is a clear indication that no program is reading from 
or writing to the drive. 

You can also remove a disk and insert a new one when an application program 
prompts you to do so. This can occur, for example, when the data that the program 
uses does not fit on one floppy disk. Note that you must never remove a disk if a 
program is reading from or writing to it. See the CP/M-68K Operating System Pro- 
grammer's Guide for more information on disk handling. 



End of Section 2 
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Section 3 
Console and Printer 



This section describes how CP/M-68K communicates with your console and printer. 
It tells how to start and stop console and printer output, edit commands you enter 
at your console, and redirect console and printer input and output. It also explains 
the concept of logical devices under CP/M-68K. 



3.1 Controlling Console Output 

Sometimes CP/M-68K displays information on your screen too quickly for you to 
read it. Sometimes an especially long display scrolls off the top of your screen before 
you have a chance to study it. To ask the system to wait while you read the display, 
hold down the CTRL key and press S. A CTRL-S keystroke causes a pause in the 
display. When you are ready, press CTRL-Q to resume the display. 



3.2 Controlling Printer Output 

You can also use a control command to echo console output at the printer, if you 
have one. To start printer echo, enter a CTRL-P. To stop printer echo, enter another 
CTRL-P. While printer echo is in effect, any characters that appear on your screen 
are listed at your printer. 

You can use printer echo with a DIR command to make a list of files to store on 
a floppy disk. You can also use CTRL-P with CTRL-S and CTRL-Q to make a hard 
copy of part of a. file. Use a TYPE command to start the display of the file at the 
console. When the display reaches the part you need to print, press CTRL-S to stop 
the display, CTRL-P to enable printer echo, and then CTRL-Q to resume the display 
and start printing. You can use another CTRL-S, CTRL-P, CTRL-Q sequence to 
terminate printer echo. 
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3.3 Console Line Editing 

You can correct simple typing mistakes in the command line with the BACK- 
SPACE or CTRL-H key. CP/M-68K also supports additional line-editing functions 
that you perform with control characters. You can use the control characters to edit 
command lines or input lines to most programs. 

CP/M-68K allows you to edit your command line using the set of characters listed 
in Table 3-1. To edit a command line in CP/M-68K, use control characters to delete 
characters left of the cursor, then replace them with new characters. 

In the following example command line, the command keyword PIP is mistyped. 
The underbar represents the cursor. 

A>POP £;=£.•#♦#_ 

To move the cursor to the letter O, hold down the CTRL key and press the letter H 
eleven times. CTRL-H deletes characters as it moves the cursor left, leaving the 
following command line: 

A>P_ 

Now you can type the correct letters, press RETURN, and send the command to 
CP/M-68K. 

A>PIP A:=B:***_ 
Table 3-1 lists all line-editing control characters for CP/M-68K. 
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3.3 Console Line Editing 



Table 3-1. CP/M-68K Line-editing Control Characters 



Character 


Meaning 


CTRL-E 


Forces a physical RETURN but does not send the command line 
to CP/M-68K. Moves the cursor to the beginning of the next 
line without erasing your previous input. 


CTRL-H 


Deletes a character and moves the cursor left one character posi- 
tion. Has the same function as backspace. 


CTRL-I 


Moves the cursor to the next tab stop. Tab stops are automati- 
cally set at each eighth column. Has the same effect as pressing 
the TAB key. 


CTRL-J 


Sends the command line to CP/M-68K and returns the cursor to 
the left of the current line. Has the same effect as a RETURN 
or a CTRL-M. 


CTRL-M 


Sends the command line to CP/M-68K and returns the cursor to 
the left of the current line. Has the same effect as a RETURN 
or a CTRL-J. 


CTRL-R 


Places a # at the current cursor location, moves the cursor to 
the next line, and displays any partial command you typed so 
far. Pressing RETURN sends the command to CP/M-68K. 


CTRL-U 


Discards all the characters in the command line, places a # at 




the current cursor position, and moves the cursor to the next 
command line. 


CTRL-X 


Discards all the characters in the command line, and moves the 
cursor to the beginning of the current line. 



You probably noticed that some control characters have the same meaning. For 
example, the CTRL-J and CTRL-M keystrokes have the same effect as pressing the 
RETURN key; all three send the command line to CP/M-68K for processing. Also, 
CTRL-H has the same effect as pressing the BACKSPACE key. 
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3.4 Assigning Logical Devices 

Most CP/M-68K computer systems have a traditional console with a keyboard and 
screen display. Many also have letter-quality printers. If you use your computer for 
unusual tasks, you might want to add a different kind of character device to your 
system: a line printer, a teletype terminal, a modem, or even a joystick for playing 
games. To keep track of these physically different input and output devices, 
CP/M-68K associates different physical devices with" logical devices. When you receive 
your CP/M-68K system, the logical devices are assigned to physical devices as shown 
in Table 3-2. 



Table 3-2. CP/M-68K Logical Devices 


Logical Name 


Device Type 


Physical Assignment 


CON: 


Console input 


Keyboard 


CON: 


Console output 


Screen 


AUXI: 


Auxiliary input 


Auxiliary input port 
(if one exists) 


AUXO: 


Auxiliary output 


Auxiliary output port 
(if one exists) 


LST: 


List output 


Printer 

(if one exists) 



The assignment of logical names to physical devices is done by the hardware 
manufacturer. However, in some implementations of CP/M-68K, you can change 
these assignments with the STAT command. For example, you can assign AUXI and 
AUXO to a modem so that your computer can communicate with others over the 
telephone. The section on STAT in the "Command Summary", Section 5, describes 
how to accomplish this. 



End of Section 3 
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Section 4 
CP/M-68K Command Concepts 



As we discussed in Section 1, a CP/M-68K command line consists of a command 
keyword, an optional command tail, and a RETURN keystroke. This section de- 
scribes the two kinds of programs the command keyword can identify, and tells how 
CP/M-68K searches for a program file on a disk. It also tells how to execute multiple 
CP/M-68K commands, and how to reset the disk system. 



4.1 Two Kinds of Commands 

A command keyword identifies a program that resides either in memory as part of 
CP/M-68K, or on a disk as a program file. Commands that identify programs in 
memory are called built-in commands. Commands that identify program files on a 
disk are called transient utility commands. 

Seven built-in commands and several transient utility commands are included with 
CP/M-68K. You can add utilities to your system by purchasing various CP/M-68K- 
compatible application programs. If you are an experienced programmer, you can 
also write your own utilities that operate with CP/M-68K. 

4.1.1 Built-in Commands 

Built-in commands are part of CP/M-68K and come into memory when you boot 
the system. Because they reside in memory, built-in commands have two advantages 
over transient commands: 

■ Built-in commands are always available regardless of the current user area or 
default drive displayed in the command prompt. 

■ Built-in commands start executing more quickly than the transient utilities 
because they do not have to be read from a disk. 
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Section 5 gives you the operating details of the built-in commands listed in Table 
4-1. 



Table 4-1. Built-in Commands 



Command 


Function 


DIR 


Displays filenames of files marked with the DIR (DIRectory) 
attribute in the directory. 


DIRS 


Displays filenames of files marked with the SYS (SYStem) attri- 
bute in the directory. 


ERA 


Erases a file from the disk by removing the filename from the 
directory and by releasing the storage space occupied by the 
file. 


REN 


Renames a disk file. 


SUBMIT 


Executes a list of commands contained in a SUBMIT file that 




you create. 


TYPE 


Displays contents of an ASCII (character) file at your screen. 


USER 


Changes to a different user number. 



CP/M-68K does not allow you to abbreviate the built-in commands. 

4.1.2 Transient Utility Commands 

A transient utility command executes a program that comes into memory only 
when you request it. When you enter a command keyword that identifies a transient 
utility, CP/M-68K loads the program file from the disk and passes it any filenames, 
data, or parameters you entered in the command tail. Because these programs are 
loaded from disk, the disk with the program file must be accessable to execute the 
command. See Section 4.2 for an explanation of how CP/M-68K searches for com- 
mand files. 
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4.1 Two Kinds of Commands 



Section 5 provides the operating details for the most frequently used CP/M-68K 
transient utilities listed in Table 4-2. Less frequently used utilities are described in the 
CP/M-68K Operating Systems Programmer's Guide. Many of these utilities are pro- 
gramming tools you might never need to use; however, they are mentioned in Table 
4-2. 





Table 4-2. Transient Utility 


Commands 


Name 


Function 


Where Explained 


AR68 


Stores object files in the C 
run-time library: the Archive 
utility. 


CP/M-68K Programmer's 
Guide 


AS68 


Invokes the assembler. 


CP/M-68K Programmer's 
Guide 


C 


Invokes a submit file for 
calling the C language 
compiler. 


C Programming Guide for 
68K 


C068 


Intermediate compiling steps 
for the C language. 


C Programming Guide for 
68K 


C168 


Intermediate compiling steps 
for the C language. 


C Programming Guide for 
68K 


CP68 


Invokes the C Language 
Preprocessor for processing 
macros. 


C Programming Guide for 
68 K 


COPY 


Copies disks (including 
CP/M-68K boot disks). 


CP/M-68K User's Guide, 
Section 5 


DDT 


Invokes DDT, the 
CP/M-68K debugger. 


CP/M-68K Programmer's 
Guide 


DUMP 


Displays a file in ASCII and 
hexadecimal formats. 


CP/M-68K Programmer's 
Guide 
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Table 4-2. (continued) 



Name 


Function 


Where Explained 


ED 


Creates and alters character 
files. 


CP/M-68K User's Guide, 
Section 5, 6 


FORMAT 


Marks all disk sectors with 
the appropriate density and 
length. 


CP/M-68K User's Guide, 
Section 5 


INIT 


Prepares a disk so that 
CP/M-68K can write on it. 
INIT erases any files and 
directory entries that are on 
the disk prior to execution. 


CP/M-68K User's Guide, 
Section 5 


LO68 


Invokes the Linker. 


CP/M-68K Programmer's 
Guide 


NM68 


Invokes the NM68™ utility 
that prints the symbol table. 


CP/M-68K Programmer's 
Guide 


PIP 


Copies, combines, or trans- 
fers specified files between 
peripheral devices. 


CP/M-68K User's Guide, 
Section 5 


RELOC 


Relocates a command file 
containing relocation infor- 
mation to an absolute 
address. 


CP/M-68K Programmer's 
Guide 
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Table 4-2. (continued) 



Name 


Function 


Where Explained 


SENDC68 


Converts a command file to 


CP/M-68K Programmer's 




the Motorola S-record 


Guide 




format. 




SIZE68 


Prints the size of a com- 


CP/M-68K Programmer's 




mand file. 


Guide 


STAT 


Shows the access status for 


CP/M-68K User's Guide, 




disks or files, the amount of 


Section 5 




free space on disks, the 






space occupied by files, or 






the logical-to-physical as- 






signment of devices, ac- 






cording to options specified 






in the command line. 





4.2 How CP/M-68K Searches for Program and Data Files 

This section describes how CP/M-68K searches for program and data files on disk. 
You need to understand the steps CP/M-68K follows, especially if it appears that 
CP/M-68K cannot find a program file you specified with a command keyword in a 
command line. If, for example, you have more than one disk drive on your system, 
the problem might be that CP/M-68K is not looking on the drive where the file is 
stored. 

4.2.1 Finding Data Files 

As you recall, when you enter a command line CP/M-68K passes the command 
tail to the program identified by the command keyword. If the command tail contains 
a file specification without a drive specification, the program asks CP/M-68K to 
search for the data file on the default drive and current user area. 
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For example, if you enter the following command line: 

3A >DIR MYFILE, TXT 

then CP/M-68K limits its search to user 3, drive A. If MYFILE.TXT has the DIR 
attribute and exists in user 3, drive A, CP/M-68K confirms the file's existence by 
displaying the filename on your screen: 

kiMYFILE.TXT 

Note that the user number does not appear in the directory listing. DIR also 
reports, System Files Exist, if user 3, drive A, contains files marked with the SYS 
attribute. 

If MYFILE.TXT has the SYS attribute and exists in user 3, drive A, DIR merely 
reports that, System Files Exist; the filename MYFILE.TXT is not echoed to the 
screen. 

Whether a data file is marked SYS or DIR, the search for a data file does not 
extend beyond the current user area and current drive. If CP/M-68K cannot find the 
data file, the program displays an error message at the console. Typically, this mes- 
sage is, File not found, or, No File; which message appears depends on the 
program identified by the command keyword. 

4.2.2 Finding Program Files 

When searching for a command file, CP/M-68K uses an extensive search pattern. 
This search is based on your command keyword and filetype which you may or may 
not supply. 

If you add a filetype to your command keyword, CP/M-68K first searches the 
current user area for the command file with that filetype. If it cannot find the file in 
the current user area, CP/M-68K searches user area for the command file having 
the filetype you supplied. 
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If you omit a filetype to your command keyword, CP/M-68K tries to supply one 
for you based on the following search pattern: 

■ CP/M-68K first checks the current user area and drive to see if there is a 
program file with your command keyword as its name and 68K as its filetype. 
If that file does not exist, then CP/M-68K checks to see if it has a blank 
filetype. If the filetype is neither 68K nor blank, CP/M-68K then checks to see 
if the program file has a filetype of SUB. 

■ If the program file has none of these filetypes in the current user area, then 
CP/M-68K checks user area for the same search pattern: first for the 68K 
filetype, then for the blank filetype, and finally for the SUB filetype. 

■ At any point in the search process, CP/M-68K stops the search if it finds the 
program file. CP/M-68K then loads the program into memory and executes it. 
When the program terminates, CP/M-68K displays the system prompt and 
waits for your next command. 

■ If CP/M-68K does not find the command file, it repeats the command, follows 
it with a question mark, and waits for your next command. 

If you include a drive specifier before the command keyword, CP/M-68K first 
looks for the program file on the specified drive in the current user area. If the 
program file is not found there, CP/M-68K searches user area on the same drive. 
The search goes no further than this when a drive specifier is included in the com- 
mand keyword. 



4.3 Executing Multiple Commands 

In the examples used so far, CP/M-68K has executed only one command at a time. 
CP/M-68K can also execute a list of commands. You can enter a list of commands 
at the system prompt, or you can put a frequently needed list of commands in a disk 
file. Once you have stored the list in a disk file, you can execute the list whenever 
you need to with a SUBMIT command. 
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To list multiple commands on the command line, separate each command keyword 
and command tail from the next keyword with an exclamation point. When you 
complete the list, press RETURN. CP/M-68K executes your commands in sequence, 
as shown below: 

3A>di rs ! di r examp* ♦ #/ stat a; 

CP/M-68K responds to the first of your three commands by reporting 

NON-SYSTEM FILE(S) EXIST 

Without waiting for any operator intervention, CP/M-68K executes the second 
command: 

3A di r examp*.* 

A: EXAMP7 : EXAMP 1 TXT : EXAMP3 : EXAMP2 TXT : EXAMP4 
A: EXAMP5 : EXAMPB 

Finally it executes the third command in the series: 

3A>stat a: 

A: RN t Free Space: 98k 

If you find you need to execute the same command list frequently, store the list in 
a disk file. See the description of the SUBMIT command in Section 5 for how to 
repeatedly execute a list of commands. 



4.4 Terminating Programs 

There might be times when you want to terminate a running program before it 
terminates itself. You can terminate the DIR, DIRS, TYPE, and SUBMIT built-in 
commands and all transient utilities, supplied with CP/M-68K whether invoked sin- 
gly or in a multiple command line, simply by holding down the control key as you 
press the C key. On many keyboards, the word control is abbreviated to CTRL. In 
addition, a CTRL-C can terminate many of the application programs that you run 
with your CP/M-68K operating system. 
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You enter a CTRL-C during program execution as the first character after the 
system prompt. CTRL-C does not work, for example, at the end of a command line, 
before you press RETURN. 

If you try to abort a program other than DIR, DIRS, TYPE, or SUBMIT, you 
might experience a delay between the time you press CTRL-C and the time the 
program terminates because CP/M-68K checks CTRL-C only when reading from or 
writing to the console. 

When you press CTRL-C during a program's execution CTRL-C causes a warm 
start, sometimes called a warm boot. Unlike other versions of CP/M, a warm start in 
CP/M-68K does not reload the operating system from your disk back into your 
computer's memory; CP/M-68K is always resident in memory. In CP/M-68K, a warm 
start does two things: it empties that portion of memory occupied by transient utili- 
ties and application programs, and it also resets all drives to a Read- Write state. At 
the end of a normal program execution of a transient utility or a built-in command, 
CP/M-68K performs a warm start. 



4.5 Parts of a File Specification 

This section describes the three parts of a file specification in a command line. To 
avoid confusion, each part is given a formal name. The three parts of a file specifica- 
tion are as follows: 

■ drive specifier — the optional disk drive A, B, C, ..., P that contains the file or 
group of files to which you are referring. If a drive specifier is included in 
your command line, a colon must follow it. 

■ filename — the one- to eight-character first name of a file or group of files. 

■ filetype — the optional one- to three-character category name of a file or group 
of files. If the filetype is present, a period must separate it from the filename. 

If you do not include a drive specifier, CP/M-68K automatically uses the default 
drive. If you omit the period and the filetype, CP/M-68K automatically includes a 
filetype of three blanks. 
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This general form is called a file specification. A file specification names a particu- 
lar file or group of files in the directory of the on-line disk given by the drive 
specifier. For example, 

B:MYFILE.DAT 

is a file specification that indicates drive B:, filename MYFILE, and filetype DAT. File 
specification is abbreviated to simply 

f i 1 espec 

in the command syntax statements in Section 5. 

Some CP/M-68K commands accept wildcards in the filename and filetype parts of 
the command tail. For example, 

B:MY*.A?? 

is a file specification with drive specifier B:, filename MY*, and filetype A??. This file 
specification might match several files in the directory. 

Put together, the parts of a file specification are represented like this: 

drfilename.typ 

In the above form, d: represents the optional drive specifier, filename represents 
the one- to eight-character filename, and typ represents the optional one- to three- 
character filetype. The syntax descriptions in this section use the term filespec to 
indicate any valid combination of the elements included in the file specification. The 
following list shows valid combinations of the elements of a CP/M-68K file specification. 

■ filename 

■ filename.typ 
a d: filename 

■ drfilename.typ 
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4.5 Parts of a File Specification 



The characters in Table 4-3 have special meaning in CP/M-68K, so do not use 
these characters in a file specification except as indicated. 



Ta 


ble 4-3. Command Line Delimiters 


Character 


Meaning 


<> = ,| 

/;&()+ - \ 
tab [ ] space 
RETURN keystroke 


file specification delimiters 


: 


drive delimiter in file specification 


• 


filetype delimiter in file specification 


< > 


option list delimiters, reserved for future use 


1 


command separator 


[] 


option list delimiters for global and local options 


» 


comment delimiter at the beginning of a command 
line 
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CP/M-68K has already established several file groups. Table 4-4 lists some of their 
filetypes with a short description of each family. Appendix B provides the complete 
list. 





Table 4-4. CP/M-68K Filetypes 


Filetype 


Meaning 


S 


assembler source file 


68K 


68000 or equivalent machine language program 


REL 


relocatable executable program file 


C 


C language source file 


SUB 


list of commands to be executed by SUBMIT 


$$$ 


temporary file 



In some of the command summaries, descriptive qualifiers are used in the syntax 
line with filespecs to further qualify the type of filespec accepted by the commands. 
For example, wildcard-filespec denotes wildcard specifications, dest-filespec denotes a 
destination filespec, and src-filespec denotes a source filespec. 
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4.6 How Commands are Described 

In Section 5, the Command Summary, CP/M-68K commands appear in alphabeti- 
cal order. Each command description is given in a specific form. Section 5 also 
describes the notation that indicates the optional parts of a command line and other 
syntax notation. 

■ The description begins with the command keyword in upper-case. 

■ The syntax section gives you one or more general forms to follow when you 
compose the command line. 

■ The explanation section defines the general use of the command keyword, and 
points out exceptions and special cases. The explanation sometimes includes 
tables or lists of options that you can use in the command line. 

■ The examples section lists a number of valid command lines that use the 
command keyword. 

The notation in the syntax lines describes the general command form using these 
rules: 

■ Words in capital letters must be spelled as shown, but you can use any com- 
bination of upper- or lower-case letters. 

■ A lower-case word in the syntax line has a general meaning that is defined in 
the text. 

■ The symbolic notation d:, filename, .typ, and filespec have the general mean- 
ings described in Section 4.5. 

■ You must include one or more space characters where a space is shown, 
unless otherwise specified. For example, the PIP options do not need to be 
separated by spaces. 
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The following table defines the special syntactical symbols used in defining com- 
mand line syntax. Unless otherwise noted, none of these symbols actually appear on 
your screen's command line; they exist solely on these pages so that can see the 
general form for a given command line. Understanding this notation helps you form 
a valid command. 



Table 4-5. Command Line Conventions 



Symbol 


Meaning 


n 


You can substitute a number for n. 


o 


You can substitute an option or a list of options. 


s 


You can substitute a string, which consists of a group of 




characters, for s. 


{} 


Items within braces are optional. You can enter a command 




without the optional items. The optional items add effects to 




your command line. 


[] 


Items in square brackets are options or an option list. If you 




use an option specified within the brackets, the brackets must 




enclose the option. If the right bracket is the last character on 




the command line, it can be omitted. These brackets actually 




appear on your command line, having the same meaning on 




a command line as they do in our command summary 




examples. 





Items in parentheses indicate a range of options. If you use a 




range from an option list, you must enclose the range within 




parentheses. 




Ellipses tell you that the previous item can be repeated any 




number of times. 


1 


The or bar separates alternative items in a command line. 




You can select any or all of the alternatives specified. Mutually 




exclusive options are indicated in additional syntax lines or 




are specifically noted in the text. 
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Table 4-5. (continued) 



Symbol 



Meaning 



t or CTRL 



<cr> 



Represent the CTRL key on your keyboard. As a rule, control 
characters that do not have a command-line editing function 
appear on the screen, with the sign, A , preceding the letter. 
Control characters that have command-line editing functions 
(See Table 3-1) do not appear on the screen when they are 
executed. 

Indicates a RETURN keystroke. In most of the examples in 
this book, the RETURN keystroke is implied and therefore 
does not appear in the examples. 

Wildcard character — replaces all or part of a filename or file- 
type. Appears on your screen and has the same meaning as it 
does in our command summary examples. 

Wildcard character— replaces any single character in the same 
position of a filename or filetype. Appears on your screen and 
has the same meaning as it does in our command summary 
examples. 



Let's look at some examples of syntax notation. The CP/M-68K DIR (DIRectory) 
command displays the names of files catalogued in the disk directory. 
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The syntax of the DIR command shows how to use the command line syntax 
notation: 

Syntax: 

DIR{d:} | {filespec} 

I I 

optional optional 

This tells you that the command tail following the command keyword DIR is 
optional. In other words, DIR alone, or DIR with a filespec, or DIR with just a drive 
specifier, or DIR with a drive specifier and a filespec all are valid versions of the DIR 
command. For example, 

DIR 

DIR J o h n » 1 1 r 

DIR b : 

DIR b : j o h n ♦ 1 1 r 

DIR b : J o h n ♦ * 

DIR b :*♦ 1 1 r 

DIR b : * ♦ * 

are valid commands. The last example, incidentally, is equivalent to DIR b:, as 
shown by the general syntax: 

DIR {d:} | {filespec} 

These are the only forms DIR can take with respect to john.ltr, or any file, or no file. 
Understanding the syntax lets you see all the possibilities. 
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The CP/M-68K command PIP (Peripheral Interchange Program) provides an exam- 
ple of a different kind of syntax. PIP can copy files from the disk to the screen or 
printer. PIP can combine two or more files into one longer file. PIP can also rename 
files after copying them. All of this functionality can be represented in the syntax 

PIP dest-filespec = src-filespec{,filespec...} 

In this example, dest-filespec is further defined as a destination file specification or 
peripheral device (printer, for example) that receives data. Similarly, src-filespec is a 
source file specification or peripheral device (keyboard, for example) that transmits 
data. PIP accepts wildcards in the filename and filetype. See the PIP command in 
Section 5 for details regarding other capabilities of PIP. There are, of course, many 
valid command lines that come from this syntax. Some of them are shown below. 

A>PIP NEUFILE.DflT=OLDFILE*DAT 

A>PIP B:=A:THISFILE,DAT 

A>PIP B:X.BflS=Y.BAS f Z.BflS 

A>PIP X*BAS=Pi.BASt B.BAS* C.BAS 

A>PIP B:=A:# t BPiK 

A>PIP B:=A:-#*# 



End of Section 4 
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Section 5 
Command Summary 



This section describes the commands and programs supplied with your CP/M-68K 
operating system. The commands are in alphabetical order. Each command is fol- 
lowed by a short explanation of its operation and examples. ED, the CP/M-68K 
editor, is described in detail in Section 6. Other commands, such as AS68 and 
DDT-68K™, are described fully in the CP/M-68K Operating System Programmer's 
Guide. 
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The COPY (Copy Disk) Command 

Syntax: COPY {option list} 

Explanation: COPY copies the contents of one disk onto another. It does so on a 
track-by-track basis, giving you a literal image of the disk or a selective 
part of the disk you want to copy. 

Unlike PIP, which needs to know both the type and length of file to be 
copied, COPY is not sensitive to the types of files or their lengths. Even 
so, COPY requires that your destination disk have the same format as 
your source disk. Hence you may have to format a destination disk 
before using COPY. If so, see FORMAT for details. 

As shown in the above syntax, you can type copy and then press the 
RETURN key. This is the simplest form of executing COPY. It is also 
the most interactive. When you load COPY this way, the following 
prompt comes to your screen: 

Copy Ve r 1 ♦ 1 

A mode menu then appears: 

MODE FUNCTION 

ALL Copy the whole disK 

BOOT Copy the boot tracKs 

FILES Copy the non-boot tracKs 

END End this program 

Choose one mode from the mode menu. For example, if you want to 
copy everything on one of your CP/M-68K disks, choose ALL to copy 
CP/M-68K and all files beyond the boot tracks. Choose BOOT if you 
want to copy only the boot loader for CP/M-68K. Choose FILES if you 
want to copy only the non-boot tracks. Choose END if you want to 
leave the COPY program and return to the command level of 
CP/M-68K. 

Once you have selected your mode, COPY prompts you with 

Enter SOURCE drive: _ 
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At the cursor position, type a drive letter in the range a...p and press 
the RETURN key. 

Similarly, you get the prompt: 

Enter DESTINATION drive: 

Reply with a drive letter in the range a...p and press the RETURN key. 
COPY prompts: 

( A C to ABORT) 

RETURN to copy <mode> from <source> to < destination) 

Mode, source, and destination have actual values on your screen in 
place of the words shown here. If these are the values you truly want 
COPY to use, press the RETURN key. COPY begins copying at this 
point, as indicated by the message, ***Copying nn Tracks***, that 
appears at the bottom of your screen. The nn in this prompt stands for 
the actual track numbers currently being copied. 

If you decide to abort the copy process, type CTRL-C (that is, hold 
down the CONTROL key and press the letter C). If you have not used 
the [A] (for automatic) option when you were at the CP/M-68K com- 
mand line, then you are offered a chance to do some more copying 
when COPY finishes your first copy. COPY saves the parameters you 
gave it for the last copy just made; then COPY asks you: 

Do you wish to repeat the copy? _ 

Type y if you do, n if you do not. If you type n, the COPY program 
ends without any further processing and returns you to the CP/M-68K 
command level. If you type y, COPY shows you the values used in the 
last copy session and invites you to start another copy session by enter- 
ing a carriage return. For example, if you chose mode ALL, source 
drive A, and destination drive B in your initial copy session, COPY 
returns the following prompt for all subsequent copy sessions: 

( A C to ABORT) 

RETURN to copy ALL from A to B 
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If you decide at this point not to begin a new session, type CTRL-C. 
CTRL-C returns you to the command level of CP/M-68K. 

Examples: Instead of typing COPY and pressing the RETURN key at the com- 
mand level, you can supply your copy options before COPY is loaded 
and executed. However, if you take advantage of this shortcut, you 
must present your options in a certain order. The order for COPY 
options is 



{mode option} before 
{source drive option} before 
{destination drive option} before 
{automatic carriage return option} 

and/or {verify option} before 
{manual carriage return} 



Some representative combinations of the COPY command line appear 
below: 

COPY ALL 
COPY ALL A 
COPY ALL A B 
COPY ALL A B [A] 
COPY ALL A B [V] 
COPY ALL A B [AV] 

COPY A 
COPYB 
COPY [A] 
COPY [V] 
COPY [AV] 

COPY A B 
COPY A B [A] 
COPY A B [V] 
COPY A B [AV] 

COPY ALL A B 
COPY ALL A B [A] 
COPY ALL A B [V] 
COPY ALL A B [AV] 
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With the exception of the A and V options, which are discussed below, 
each of the options in the examples is explained in the preceding basic, 
interactive COPY session. 

Note: be sure the source drive appears to the left of the destination 
drive in your option list. If you inadvertently get the the drive letters of 
your destination drive and source drive turned around in this option 
list, you will copy your destination disk (probably blank) onto your 
source disk, thereby wiping it out. Avoid this by entering the source 
drive letter before you specify the destination drive letter. Then recheck 
what you typed before you press the RETURN key. 

The bracketed A acts as a virtual RETURN key at run-time when the 
operator normally would be required to set the copy process in motion 
once the parameters have been supplied to COPY. Specifying the [A] 
option allows the copy process to execute without interruption and 
without further operator interaction. 

The bracketed V invokes COPY's verification option. When you use 
the bracketed V, COPY compares the data on source and destination 
disks following a copying operation, to verify that the data on the two 
disks are the same. COPY with the V option runs more slowly than 
COPY without the V option. This is because the V demands that COPY 
go through extra steps in reading the destination disk and comparing 
its data to the data on the source disk. 

If you enter more options in the option list than COPY uses, those 
extra options are thrown away. For example, if you type 

A > COPY FILES A B HELLO THERE 

the COPY utility loads then displays the message: 

Extraneous argument ignored: hello 
Extraneous argument ignored: there 
<*C to ABORT) 
RETURN to copy FILES from A to B _ 

Thus COPY helps salvage the copy session for you by allowing you to 
either abort COPY or else continue with the copy process, using the 
only three valid options it found from the command line in this example. 
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The DIR (Directory) and DIRS (System Directory) Commands 

Syntax: DIR {d:} 

DIR {filespec} 

DIRS {d:} 
DIRS {filespec} 

Explanation: The DIR and DIRS built-in commands display the names of files con- 
tained in the directory of an on-line disk. 

The DIR command lists the names of files in the current user area that 
have the Directory (DIR) attribute. The DIRS command displays the 
names of files in the current user area that have the System (SYS) 
attribute. 

All executable files in user area 0, regardless of their SYS or DIR attri- 
bute, can be executed regardless of the current user number. However, 
you must be in user area to display those files with DIR or DIRS. 

If the drive and file specifications are omitted, the DIR command dis- 
plays the names of all files with the DIR attribute on the disk in the 
default drive and current user number. In the same way, DIRS displays 
the SYS files. 

If the drive specification is included, but the filename and filetype are 
omitted, the DIR command displays the names of all DIR files in the 
current user area on the disk in the specified drive. DIRS displays the 
SYS files. 

Both DIR and DIRS accept wildcard filenames and filetypes. When you 
use wildcard characters, all filenames that satisfy the match are dis- 
played on the screen. 

If no filenames match the file specification, or if no files are catalogued 
in the directory of the disk in the named drive and user number, the 
DIR and DIRS commands each display the message: 

No File 
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If system (SYS) files that reside on the specified drive and user number 
match the file specification, DIR displays the message: 

SYSTEM FILE(S) EXIST 

If nonsystem (DIR) files match the file specification, DIRS displays the 
message: 

NON-SYSTEM FILES(S) EXIST 

Examples: A> DIR 

Displays all DIR files catalogued in user on the default drive A. 

f\>DIR B: 

Displays all DIR files for user on drive B. 

A>DI/? B: X.BAS 

Displays the name X.BAS if the file X.BAS is present on drive B. 

4A>0I/? x.BAS 

Displays all DIR files with filetype BAS for user 4 on drive A. 

B>DIR A:X#.C?D 

Displays all DIR files for user on drive A whose filename begins with 
the letter X, and whose three character filetype contains the first char- 
acter C and last character D. 

A>DI/?S 

Displays all files for user on drive A that have the system (SYS) 
attribute. 

3A >DIRS **G8K 

This wildcard form of the DIRS command displays all SYS files with 
filetype 68 K on the default drive A for user 3. 
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The ED (Character File Editor) Command 

Syntax: ED input-filespec {d: | output-filespec} 

Explanation: The ED transient utility lets you create and edit a disk file. 

The ED utility is a line-oriented context editor. This means that you 
create and change character files line-by-line, or by referencing individ- 
ual characters within a line. 

The ED utility lets you create or alter the file named in the file specifi- 
cation. Refer to Section 6 for a more detailed description of the ED 
utility. 

The ED utility uses a portion of your user memory as the active text 
buffer where you add, delete, or alter the characters in the file. You use 
the A command to read all or a portion of the file into the buffer. You 
use the W or E command to write all or a portion of the characters 
from the buffer back to the file. 

An imaginary character pointer, called CP, is at the beginning of the 
buffer, between two characters in the buffer, or at the end of the buffer. 

You interact with the ED utility in either command or insert mode. ED 
displays the * prompt on the screen when ED is in command mode. 
When the * appears, you can enter the single letter command that reads 
text from the buffer, moves the CP, or changes the ED mode of opera- 
tion. When in command mode, you can use the line-editing characters 
CTRL-E, -H, -U, -X, and RUBOUT to edit your input. In insert mode, 
however, you use only CTRL-H, -U, -X, and RUBOUT. 
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Table 5-1. ED Command Summary 



Command Action 



nfi 



Append n lines from original file to memory buffer. 



OA 



Append file until buffer is one-half full or until 
end of input is reached. 



#A 



Append file until buffer is full (or end-of-file). 



B, -B 



Move CP to beginning (B) or bottom (-B) of buffer. 



nCt -nC 



Move CP n characters forward (C) or back (-C) 
through buffer. 



nD t -nD 



Delete n characters before (-D) or from (D) the 
CP. 



Save new file and return to CP/M-68K. 



Fstrina-C \ Z> 



Find character string. 



H 



Save the new file, then reedit, using the new file 
as the original file. 
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Table 5-1. (continued) 



Command Action 



Enter insert mode; use f Z to exit insert mode. 



I s t r i n 9< f Z > 



Insert string at CP. 



Jsearch-str"Zins-str A Zdel-.to-str{\Z> 
Juxtapose strings. 



nK t -nK 



Delete (kill) n lines from the CP. 



nL t -nL t OL 



Move CP n lines. 



nNcotiiMands 



Execute commands n times. 



n t -n 



Move CP n lines and display that line. 



Move to line n. 



: n co mm and 



Execute command through line n. 



A/st rin^-f f Z> 



Extended find string. 
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Table 5-1. (continued) 



Command 


Action 









Return to original file. 


nP* -nP 






Move CP 23 lines forward and display 23 lines 




at console. 


Q 






Abandon new file, return to CP/M-68K. 


R 






Read X$$$$$$$.LIB file into buffer. 


Rfi lespeci | 


Z> 




Read filespec into buffer. 


Sdelete st rimf A Zinse rt st rin &{ | Z > 




Substitute string. 


nT t -nTt OT 






Type n lines. 


Ut -U 






Upper-case translation. 


Vt -Kit OV 






Line numbering on/off, display free buffer space. 
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Table 5-1. (continued) 



Command 


Action 




nW 




Write n lines to new file. 




nX 




Write or append n lines to 


X$ $$$$$$. LIB. 


nXfi 


1 esP9c{ 


t Z> 








Write n lines to filespec or append if previous x 
command applied to the same file. 


OX 




Delete file X$$$$$$$.LIB. 




OXfi 


1 espec{ 


fz> 

Delete filespec. 




nZ 




Wait n seconds. 
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The ERA Command 

Syntax: ERA {filespec} 

Explanation: The ERA command removes one or more files from the directory of a 
disk. Wildcard characters are accepted in the filespec. Directory and 
data space are automatically reclaimed for later use by another file. 

Use the ERA command with care because all files that satisfy the file 
specification are removed from the disk directory. 

Command lines that take the form: 

ERA {d:}wildcard-filespec 

require your confirmation because they erase an entire group of files, 
not just one file. The system prompts with the following message: 

Conf i rm (Y/N)? 

Respond with y if you want to remove all matching files, and n if you 
want to avoid erasing any files. 

There is one instance in which the ERA command with a wildcard does 
not cause the system to prompt you. In a SUBMIT file, when you use a 
wildcard with an ERA command, CP/M-68K does not ask for confirma- 
tion. Please see the SUBMIT command. 

If no files match the file specification, you see the following message: 

No File 

Examples: A >ER AX *PAS 

This command removes the file X.PAS from the disk in drive A. 

A>E/?A *,PRN 
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The system asks to confirm: 

Confirm (Y/N)?V 

All files with the filetype PRN are removed from the disk in drive A, 
user 0. 

A>EF?A B;#,# 
Confirm (Y/N)? Y 

All files on drive B, user 0, are removed from the disk. 
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The FORMAT Command 



Syntax: FORMAT {disk drive} 

Explanation: Digital Research provides a format utility, called FORMAT, that is 
compatible with CP/M-68K and the Motorola EXORmacs™ computer. 
The EXORmacs hardware is described in the CP/M-68K Operating 
System System Guide. 

Most CP/M-68K users do not have an EXORmacs. Consequently, their 
disk formatting programs are supplied by the vendors of their non- 
EXORmacs hardware. Just the same, the formatting concepts men- 
tioned above apply to all disk users, whatever brand of hardware is 
used. 

Formatting establishes the desired disk density (either single density or 
double density), the desired sector size (128, 256, 512, or 1024), and 
the number of tracks appropriate for the disk to be formatted. Format- 
ting makes a disk ready to receive new data from another disk having 
the identical format. Thus formatting is a preliminary, and often nec- 
essary, step to copying. 

Although you can often set the density and sector size by using a for- 
matting utility, you have no control over the number of tracks that are 
selected by the utility. That parameter is determined by the particular 
disk controller logic inside your disk cabinet; it is hardware dependent. 
Consequently, computer hardware manufacturers often write the for- 
matting utilities to go with the hardware they sell. 

Whether you format a floppy disk or a hard disk, all files on the disk 
may be erased as part of the formatting procedure. The utility's behav- 
ior depends on the version supplied you by the manufacturer of your 
equipment. 
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Executing FORMAT at the CP/M-68K command level takes the form: 

A> FORMAT d 

where d specifies a disk in the range a.. .p. 

As with INIT, FORMAT asks you to reconfirm your choice in the 
following prompt: 

Do you really want to init disK d? 

Press y for yes, in either upper-case or lower-case, if you wish to con- 
tinue. Reply with n for no, if you decide not to format disk d. If you 
reply to the above question with any character other than y, FORMAT 
aborts execution and returns you to the command level of CP/M-68K. 
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The INIT Command 

Syntax: INIT {disk drive} 

Explanation: INIT initializes disk directories. That is, INIT purges the contents of an 
existing directory by marking each sector in the directory area as unused, 
ready to be written on. Once this happens, data files referenced by the 
initialized directory are virtually erased. The effect is very similar to 
ERA *.*, but more thorough than ERAse because INIT can access 
every directory entry, no matter how bizarre the directory entry might 
be. Therefore, the primary use of INIT is to clean up a corrupted 
directory. If this is your purpose, be sure to PIP any important files 
from the disk to be initialized on to a back-up disk, then use INIT. 

Note that INIT cannot change the size of your sectors or the density of 
your disk. In other words, INIT cannot reformat anything. INIT is 
hardware independent; it can be used on any computer equipped with 
Motorola's 68000 CPU and Digital Research's CP/M-68K operating 
system. 

Executing INIT from the CP/M-68K command level takes the form: 

A>IWir d 

where d specifies a drive in the range a... p. 

If initialization erases the contents of all directory entries on disk, 
CP/M-68K seeks reconfirmation of your intent before it proceeds: 

Do you really want to i n i t d i s K d ? 

Reply y for yes, or n for no, to the question. INIT proceeds to initialize 
your disk if you reply y. Reply with n for no if you decide not to 
initialize disk d. If you reply to the above question with any character 
other than y, INIT aborts execution and returns you to the command 
level of CP/M-68K. 



m DIGITAL RESEARCH™ 



5-17 



The PIP Command CP/M-68K User's Guide 

PIP (Peripheral Interchange Program-Copy File) Command 

Syntax: PIP dest-file {[Gn]} | dev = src-file {[o]} |dev {[o]} 

Explanation: The PIP utility copies one or more files from one disk and/or user 
number to another. PIP can rename a file after copying it. PIP can 
combine two or more files into one iile. PIP can also copy a character 
file from disk to the printer or other auxiliary logical output device. 
PIP can create a file on disk from input from the console or other 
logical input device. PIP can .transfer data from a logical input device 
to a logical output device. Hence the name Peripheral Interchange 
Program. 



Single File Copy 

Syntax: PIP d:{[Gn]} = source-filespec{ [options]} 

PIP dest-filespec{[Gn]} = d:{[options]} 
PIP dest-filespec{[Gn]} = source-filespec{[o]} 

Explanation: The first form shows the simplest way to copy a file. PIP looks for the 
file named by source-filespec on the default or optionally specified drive. 
PIP copies the file to the drive specified by d: and gives it the same 
name as source-filespec. If you want, you can use the [Gn] option to 
place your destination file (dest-filespec) in the user number specified by 
n. The only option recognized for the destination file is [Gn]. Several 
options can be combined together for the source file specification (source- 
filespec). See the section on PIP options. 

The second form is a variation of the first. PIP looks for the file named 
by dest-filespec on the drive specified by d:, copies it to the default or 
optionally specified drive, and gives it the same name as dest-filespec. 

The third form shows how to rename the file after you copy it. You 
can copy it to the same drive and user number, or to a different drive 
and/or user number. Rules for options are the same. PIP looks for the 
file specified by source-filespec, copies it the the location specified in 
dest-filespec, and gives it the name indicated by dest-filespec. 
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Remember that PIP always goes to and gets from the current user 
number unless you specify otherwise with the [Gn] option. 

Before you start PIP, be sure that you have enough free space in kilo- 
bytes on your destination disk to hold the entire file or files that you 
are copying. Even if you are replacing an old copy on the destination 
disk with a new copy, PIP still needs enough room for the new copy 
before it deletes the old copy. See the STAT command in this section. 

Data is first copied to a temporary file to ensure that the entire data file 
can be constructed within the space available on the disk. PIP gives the 
temporary file the filename specified for the destination, with the file- 
type $$$. If the copy operation is successful, PIP changes the temporary 
filetype $$$ to the filetype specified in the destination. 

If the copy operation succeeds and a file with the same name as the 
destination file already exists, the old file with the same name is erased 
before renaming the temporary file. 

File attributes (SYS, DIR, RW, RO) are transferred with the files. 

If the existing destination file is set to Read-Only (RO), PIP asks you if 
you want to delete it. Answer Y or N. Use the W option to write over 
Read-Only files. 

You can include PIP options following each source name (see PIP 
Options, below). There is one valid option, [Gn] - go to user number 
n, for the destination file specification. Options are enclosed in square 
brackets. Several options can be included for the source files. They can 
be packed together or separated by spaces. Options can verify that a 
file was copied correctly, allow PIP to read a file with the system (SYS) 
attribute, cause PIP to write over Read-Only files, cause PIP to put a 
file into or copy it from a specified user number, transfer from lower- 
to upper-case, and much more. 
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Examples: b>PIPB:=A:oldfile*dat 
A>PIP B:oldfile.dat = A: 

Both forms of this command cause PIP to read the file oldfile.dat from 
drive A and put an exact copy of it onto drive B. This is called the 
short form of PIP, because the source or destination names only a drive 
and does not include a filename. When using this form you cannot copy 
a file from one drive and user number to the same drive and user 
number. You must put the destination file on a different drive or in a 
different user number. See the section on PIP Options, and the section 
on the USER command. The second short form produces exactly the 
same result as the first one. PIP simply looks for the file oldfile.dat on 
drive A, the drive specified as the source. 

A>PIP B : n e uf i 1 e * d at =A : o 1 d f i 1 e * d at 

This command copies the file oldfile.dat from drive A to drive B and 
renames it to newfile.dat. The file remains as oldfile.dat on drive A. 
This is the long form of the PIP command, because it names a file on 
both sides of the command line. 

A>PIP neufile ♦ dat = old file ♦ dat 

Using this long form of PIP, you can copy a file from one drive and 
user number (usually user because CP/M-68K automatically starts 
out in user — the default user number) to the same drive and user 
number. This effectively gives you two copies of the same file on one 
drive and user number, each with a different name. 

A> PIP B: PROGRAM. BAK = A : PROGRAM . DATCG1 ] 

The command above copies the file PROGRAM.DAT from user 1 on 
drive A to user on drive B and renames the filetype on drive B, user 
0, to BAK. 
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B>PIP proZramZ* dat = A: pro <f rami * datCE V G33 

In this command, PIP copies the file named programl.dat on drive A 
and echoes [E] the transfer to the console, verifies [V] that the two 
copies are exactly the same, and gets [G3] the file programl.dat from 
user 3 on drive A. Since there is no drive specified for the destination, 
PIP automatically copies the file to the default user number and drive, 
in this case drive B, user 0. 



Multiple File Copy 

Syntax: PIP d:{[Gn]} = {d:}wildcard-filespec{[o]} 

Explanation: When you use a wildcard in the source specification, PIP copies quali- 
fying files one-by-one to the destination drive, retaining the original 
name of each file. PIP displays the message, COPYING, followed by 
each filename as the copy operation proceeds. PIP issues an error mes- 
sage and aborts the copy operation if the destination drive and user 
number are the same as those specified in the source. 

Examples: A > P I P B:=A:#* CND 

This command causes PIP to copy all the files on drive A with the 
filetype CMD to drive B. 

A>PIP B:=A:#.# 

This command causes PIP to copy all the files on drive A to drive B. 
You can use this command to make a back-up copy of your distri- 
bution disk. Note, however, that this command does not copy the 
CP/M-68K bootstrap loader from the system tracks. COPY, or any 
other track-to-track copy program, copies the system tracks for you. 

A>PIP B:=A:PROG????** 

The command above causes PIP to copy all files beginning with PROG 
and having any filetype at all from drive A to drive B. 



El DIGITAL RESEARCH™ 

5-21 



The PIP Command CP/M-68K User's Guide 



A>PIP B:[G1J=A:*.A8G 

This command causes PIP to copy all the files with a filetype of A86 on 
drive A in the default user number, user ZERO in this case, to drive B 
in user number 1. Remember that the DIR, TYPE, ERA and other 
commands only access files in the same user number from which they 
were invoked. See the USER command. 



Combining Files 

Syntax: PIP dest-file{[Gn]} = src-file{[opt]},file 

{[opt]}{,file{[opt]}...} 

Explanation: This form of the PIP command lets you specify two or more files in the 
source. PIP copies the files specified in the source from left to right and 
combines them into one file with the name indicated by the destination 
file specification. This procedure is called file concatenation. You can 
use the [Gn] option after the destination file to place it in the user 
number specified by n. You can specify one or more options for each 
source file. 

Most of the options force PIP to copy files character-by-character. In 
these cases PIP looks for a CTRL-Z character to determine where the 
end of the file is. All of the PIP options force a character transfer except 
the following: 

Gn,K,0,R,V, and W. 

Copying data to or from logical devices also forces a character transfer. 

During character transfers, you can terminate a file concatenation oper- 
ation by pressing CTRL-C. 

When concatenating files, PIP searches only the last record of a file for 
the CTRL-Z end-of-file character. However, if PIP is doing a character 
transfer, it stops when it encounters a CTRL-Z character. 

Use the [O] option if you are concatenating machine code files. The 
[O] option causes PIP to ignore embedded CTRL-Z (end-of-file) char- 
acters, normally used to indicate the end-of-file character in files. 
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Examples: A>PIP NENFILE=FILE1 >FILE2tFILE3 

The three files named FILE1, FILE2, and FILE3 are joined from left to 
right and copied to NEWFILE.$$$. NEWFILE.$$$ is renamed to 
NEWFILE upon successful completion of the copy operation. All source 
and destination files are on the disk in the default drive A. 

A>PIP B:X*A8E = Y ♦ ABG * B:Z.A8G 

The file Y.A86 on drive A is joined with Z.A86 from drive B and 
placed in the temporary file X.$$$ on drive B. The file X.$$$ is renamed 
to X.A86 on drive B when PIP runs to successful completion. 



Copy Files to and from Auxiliary Devices 

Syntax: PIP dest-filespec {[Gn]} = source-filespec {[o]} 

AXO: AXI: {[options]} 

CON: CON: {[options]} 

PRN: NUL: 

LST: EOF: 

Explanation: This form is a special case of the PIP command line that lets you copy 
a file from a disk to a device, from a device to a disk, or from one 
device to another. The files must contain printable characters. Each 
peripheral device is assigned to a logical name that identifies a source 
device that can transmit data, or a destination device that can receive 
data. A colon (:) follows each logical device name so it cannot be 
confused with a filename. Press CTRL-C to abort a copy operation that 
uses a logical device in the source or destination. 
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The logical device names are listed as follows: 

CON: Console: the physical device assigned to CON. When 

used as a source, usually the keyboard; when used as a 
destination, usually the screen. 

AXI: Auxiliary Input or Output Device. 

AXO: Auxiliary Output Device. 

LST: The destination device assigned to LST, usually the printer. 

There are three device names that have special meaning: 

NUL: A virtual source device that produces 40 hexadecimal 

zeroes. 

EOF: A virtual source device that produces a single CTRL-Z, 

the CP/M-68K end-of-file mark. 

PRN: The printer device with tab expansion to every eighth 

column, line numbers, and page ejects every 60th line. 

Examples: B>PIP PRN := CON: tMYDATA.DAT 

Characters are first read from the console input device, generally the 
keyboard, and sent directly to your printer device. You type a CTRL-Z 
character to tell PIP that keyboard input is complete. At that time, PIP 
continues by reading character data from the file MYDATA.DAT on 
drive B. Because PRN: is the destination device, tabs are expanded, line 
numbers are added, and page ejects occur every 60 lines. 

A>FJP B:FUNFILE*SUE=CON: 

If CRT: is assigned to CON:, whatever you type at the console is 
written to the file FUNFILE.SUE on drive B. You must press the 
RETURN key and the line-feed key to commit your input to the file. 
End the keyboard input by typing a CTRL-Z. Corrections of previously 
typed material are not permitted in this option. 
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A>PIP LST:=CON: 

If CRT: is assigned to CON:, whatever you type at the keyboard is 
written to the list device, generally the printer. Terminate input with a 
CTRL-Z. 

A>PIP LST:=B:DRAFT,TXTCT8] 

The file DRAFT.TXT on drive B is written to the printer device. Any 
tab characters are expanded to the nearest column that is a multiple of 



A>PIP PRN:=B: DRAFT* TXT 

The command above causes PIP to write the file DRAFT.TXT to the 
list device. It automatically expands the tabs, adds line numbers, and 
ejects pages after sixty lines. 



Multiple Command Mode 

Syntax: PIP 

Explanation: This form of the PIP command starts the PIP utility and lets you type 
multiple command lines while PIP remains in user memory. 

PIP writes an asterisk (*) on your screen when ready to accept input 
command lines. 

You can type any valid command line described under previous PIP 
formats following the asterisk prompt. 

Terminate PIP by pushing only the RETURN key following the asterisk 
prompt. The empty command line tells PIP to discontinue operation 
and return to the CP/M-68K system prompt. 
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Examples: A>PIP 

*NENFILE=FILE1 *FILEZ*FILE3 

*APROG,CMD=BPROG,CMD 

*A:=B:X,A8G 

*B : =# ♦ # 

# 

This command loads the PIP program. The PIP command input prompt 
(*) tells you that PIP is ready to accept commands. The effects of this 
sequence of commands are the same as shown in the previous exam- 
ples, where the command tail is included in the command line. PIP is 
not loaded into memory for each command. 



Using Options with PIP 

Explanation: Options enable you to process your source file in special ways. You 
can expand tab characters, translate from upper- to lower-case, extract 
portions of your text, verify that the copy is correct, and much more. 

The PIP options are listed below, using n to represent a number and s 
to represent a sequence of characters terminated by a CTRL-Z. An 
option must immediately follow the file or device it affects. The option 
must be enclosed in square brackets [ ]. For those options that require 
a numeric value, no blanks can occur between the letter and the value. 

You can include the [Gn] option after a destination file specification. 
You can include a list of options after a source file or source device. 
An option list is a sequence of single letters and numeric values that 
are optionally separated by blanks and enclosed in square brackets [ ]. 
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Table 5-2. PIP Options 



Option 



Function 



Dn 



Gn 



H 



Delete any characters past column n. This parameter 
follows a source file that contains lines too long to 
be handled by the destination device, for example, 
an 80-character printer or narrow console. The num- 
ber n should be the maximum column width of the 
destination device. 

Echo transfer at console. When this parameter fol- 
lows a source name, PIP displays the source data at 
the console as the copy is taking place. The source 
must contain character data. 

Filter form-feeds. When this parameter follows a 
source name, PIP removes all form-feeds embedded 
in the source data. To change form-feeds set for one 
page length in the source file to another page length 
in the destination file, use the F command to delete 
the old form-feeds and a P command to simultane- 
ously add new form-feeds to the destination file. 

Get source from or go to user number n. When this 
parameter follows a source name, PIP searches the 
directory of user number n for the source file. When 
it follows the destination name, PIP places the destina- 
tion file in the user number specified by n. The number 
must be in the range to 15. 

Hex data transfer. PIP checks all data for proper Intel 
hexadecimal file format. The console displays error 
messages when errors occur. This function is included 
for historical reasons only. This PIP option does not 
affect Motorola S-records. 

Ignore :00 records in the transfer of Intel hexadeci- 
mal format file. The I option automatically sets the 
H option. This function is included for historical rea- 
sons only. This PIP option does not affect Motorola 
S-records. 
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Table 5-2. (continued) 



Option 



Function 



N 



O 



Pn 



Qs 



R 



Translate upper-case alphabetics in the source file to 
lower-case in the destination file. This parameter fol- 
lows the source device or filename. 

Add line numbers to the destination file. When this 
parameter follows the source filename, PIP adds a 
line number to each line copied, starting with 1 and 
incrementing by one. A colon follows the line num- 
ber. If N2 is specified, PIP adds leading zeroes to the 
line number and inserts a tab after the number. If the 
T parameter is also set, PIP expands the tab. 

Object file transfer for machine code (noncharacter 
and therefore nonprintable) files. PIP ignores any 
CTRL-Z end-of-file during concatenation and trans- 
fer. Use this option if you are combining object code 
files. 

Set page length, n specifies the number of lines per 
page. When this parameter modifies a source file, PIP 
includes a page eject at the beginning of the destina- 
tion file and at every n lines. If n = 1 or is not 
specified, PIP inserts page ejects every 60 lines. When 
you also specify the F option, PIP ignores form-feeds 
in the source data and inserts new form-feeds in the 
destination data at the page length specified by n. 

Quit copying from the source device after the string 
s. When used with the S parameter, this parameter 
can extract a portion of a source file. The string 
argument must be terminated by CTRL-Z. 

Read system (SYS) files. Normally, PIP ignores files 
marked with the system attribute in the disk direc- 
tory. But when this parameter follows a source file- 
name, PIP copies system files, including their attri- 
butes, to the destination. 



5-28 



M DIGITAL RESEARCH™ 



CP/M-68K User's Guide 



The PIP Command 



Table 5-2. (continued) 



Option 



Function 



Ss 



Tn 



U 



V 



W 



Start copying from the source device at the string s. 
The string argument must be terminated by CTRL- 
Z. When used with the Q parameter, this parameter 
can extract a portion of a source file. Both start and 
quit strings are included in the destination file. 

Expand tabs. When this parameter follows a source 
filename, PIP expands tab, CTRL-I, characters in the 
destination file. PIP replaces each CTRL-I with enough 
spaces to position the next character in a column 
divisible by n. 

Translate lower-case alphabetic characters in the 
source file to upper-case in the destination file. This 
parameter follows the source device or filename. 

Verify that data has been copied correctly. PIP com- 
pares the destination to the source data to ensure 
that the data has been written correctly. The desti- 
nation must be a disk file. 

Write over files with RO (Read-Only) attribute. Nor- 
mally, if a PIP command tail includes an existing RO 
file as a destination, PIP sends a query to the console 
to make sure you want to write over the existing file. 
When this parameter follows a source name, PIP 
overwrites the RO file without a console exchange. 
If the command tail contains multiple source files, 
this parameter need follow only the last file in the 
list. 

Zero the parity bit. When this parameter follows a 
source name, PIP sets the parity bit of each data byte 
in the destination file to zero. The source must con- 
tain character data. 
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Examples: A>PI P NENPROG , A86=C0DE ♦ A8BELJ t DATA ♦ A8GCU3 

This command constructs the file NEWPROG.A86 on drive A by join- 
ing the two files CODE.A86 and DATA.A86 from drive A. During the 
copy operation, CODE.A86 is translated to lower-case, while DATA.A86 
is translated to upper-case. 

A>PIP C0N:=NIDEFILE t A8G[D80] 

This command writes the character file WIDEFILE.A86 from drive A 
to the console device, but deletes all characters following the 80th col- 
umn position. 

A>PIP B:=LETTER, TXT £ El 

The file LETTER.TXT from drive A is copied to LETTER.TXT on 
drive B. The LETTER.TXT file is also written to the screen as the copy 
operation proceeds. 

A>PIP LST : =B : LONGPAGE * TXTCFPG5J 

This command writes the file LONGPAGE.TXT from drive B to the 
printer device. As the file is written, form-feed characters are removed 
and reinserted at the beginning and every 65th line thereafter. 

B>PIP LST:=PR0GRAM.A8B[NT8U] 

This command writes the file PROGRAM. A8 6 from drive B to the 
printer device. The N parameter tells PIP to number each line. The T8 
parameter expands tabs to every eighth column. The U parameter 
translates lower-case letters to upper-case as the file is printed. 



m DIGITAL RESEARCH™ 



5-30 



CP/M-68K User's Guide The PIP Command 



A>FIP 

xPORTION, TXT=LETTER, TXTCSDear Si r"Z QSi nee rel y*Zl 

This command extracts a portion of the LETTER.TXT file from drive 
A by searching for the character sequence Dear Si r before starting the 
copy operation. When found, the characters are copied to POR- 
TION.TXT on drive A until the sequence Sincerely is found in the 
source file. Note that this PIP option can only be used when PIP is in the 
multiple copy mode, even if you do not intend to make multiple copies. 
This option cannot be used in single copy mode on the same line as the 
PIP command keyword. 

B>PIP B:=A:#, CMDEVHR3 

This command copies all files with filetype CMD from drive A to drive 
B. The V parameter tells PIP to read the destination files to ensure that 
data was correctly transferred. The W parameter lets PIP overwrite any 
destination files that are marked as RO (Read-Only). The R parameter 
tells PIP to read files from drive A that are marked with the SYS (Sys- 
tem) attribute. 
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The REN Command 



Syntax: REN {new-filespec = old-filespec} 

Explanation: The REN command lets you change the name of a file that is cata- 
logued in the directory of a disk. 

The new-filespec must not be the name of any existing file on the disk. 
The old-filespec identifies an existing file on the disk. 

The REN command changes the name of the file named by old-filespec 
to the name given as new-filespec. If you put a space between the old- 
filespec and the equal sign or between the new-filespec and the equal 
sign, you must insert at least one space on the opposite side of the 
equal sign. 

CP/M-68K offers you a second method of using the REN command. 
Type REN then press RETURN. REN presents the following display: 

Enter Old Name : 

The cursor appears following Enter Old Name:. Enter the filespec you 
wish to rename and press RETURN. The following line appears on 
your screen: 

Enter New Name: 

The cursor then appears following Enter New Name:. Type in the new- 
filespec and, again, press RETURN to execute the REN command. 

REN does not make a copy of the file. REN changes only the name of 
the file. 

If you omit the drive specifier, REN assumes the file to rename is on 
the default drive. You can include a drive specifier as a part of the 
newname. If both file specifications name a drive, it must be the same 
drive. 
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If the file given by oldname does not exist, REN displays the following 
message on the screen: 

No File 

If the file given by newname is already present in the directory, REN 
displays the following message on the screen: 

File Already Exists 

REN does not allow for wildcard filenames or filetypes. If you try to 
use a wildcard, REN tells you: 

No wildcard filenames 

Examples: A>/?EA/ NEUASM , BAS=OLDFILE , BAS 

The file OLDFILE.BAS changes to NEWASM.BAS on drive A. 

A>/?EW 

The system prompts for the filespecs: 

Enter Old Name : X* PRN 
Enter New Natt\eiY,PRN 
A> 

File X.PRN is renamed Y.PRN on drive A. 

B>REN A:X,PAS = Y.PLI 

The file Y.PLI changes to X.PAS on drive A. 

f\>REN B:NENLIST=B:OLDLIST 
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The file OLDLIST changes to NEWLIST on drive B. Since the second 
drive specifier, B:, is implied by the first one, it is unnecessary in this 
example. The command line above has the same effect as the following: 

b>REN B:NENLIST=OLDLIST 



or 



A>/?£W NEULIST=B:OLDLIST 
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The STAT (Status) Command 



Syntax: STAT 

STAT filespec {RO|RW|SYS|DIR|SIZE} 
STAT {d:}DSK: | USR: 
STATVAL: | DEV: 

Explanation: The various forms of the STAT utility command give you information 
about the disk drives, files, and devices associated with your computer. 
STAT lets you change the attributes of files. You can also assign physi- 
cal devices to the STAT logical device names. 

Note that the options following filespec can be enclosed in square 
brackets [ ], or be preceded by a dollar sign $, or by no delimiter as 
shown in the syntax section above. 

The notation RW tells you a file is in a Read- Write state so that data 
can be both read from and written to the file. A file marked RO, Read- 
only, can be read from but not written to. 

Unlike other CP/M products, you cannot use STAT in CP/M-68K to 
set a drive to a Read- Only state. Drives are in a Read-Write state by 
default and become Read- Only only when you remove a disk on which 
a file is open. The drive reverts to a Read- Write state whenever you 
exit a program or type a CTRL-C, either of which causes a warm boot. 
Please see Section 4.4 for a discussion of terminating programs and the 
term warm boot. 

Except for STAT VAL: and STAT DEV:, the STAT commands allow 
you to use a drive specifier. In CP/M-68K you can specify a drive that 
is different from the currently logged-in drive. The drive letter that 
appears in your system prompt identifies the logged-in drive. Execution 
of a STAT command with a drive specifier that differs from the logged- 
in drive does not change the logged-in drive. 

In a STAT command, when you specify a drive that is different from 
the logged-in drive, you place that drive in an active status. Active 
status is any drive accessed since the last warm or cold start. If you 
execute a STAT or STAT DSK: command without specifying a drive, 
STAT responds with information for any or all drives on active status. 
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Free Space on Disk 

Syntax: STAT {d:} 

Explanation: STAT with no command tail reports the amount of free storage space 
that is available on all on-line disks. This form of the STAT command 
reports free space for only those disks that have been accessed since 
CP/M-68K was last started or reloaded. You can find the amount of 
free space on a particular disk by including the drive specifier in the 
command tail. 

This form of the STAT command displays information on your screen 
in the following form: 

d: RW, Free Space: nnK 

where d is the drive specifier, and n is the number of kilobytes of 
storage remaining on the disk in the drive specified by d. 

Examples: A>S7"A7 

Suppose you have two disk drives containing active disks. Suppose also 
that drive A has 16K (16,384) bytes of free space, while drive B has 
32K (32,768) bytes of free space. The STAT command displays the 
following messages on your screen: 

A: RW t Free Space: 1GK 
B: RW t Free Space: 32K 

A>STfllT B: 

Suppose drive B has 98 Kilobytes of storage that are free for program 
and data storage. The following message is displayed on your screen: 

B: RW t Free Space: 98K 
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Files — Display File Space and Access Mode 

Syntax: STAT filespec {SIZE} 

Explanation: This form of the STAT command displays the amount of space in 
kilobytes used by the specified file. It also displays the Access Mode of 
the file. STAT accepts wildcards in the filename and filetype part of the 
command tail. When you include a wildcard in your file specification, 
the STAT command displays a list of qualifying files from the default 
or specified drive, with their file characteristics, in alphabetical order. 

Note that the S option following the filespec can be enclosed in square 
brackets [ ], or be preceded by a dollar sign $, or by no delimiter as 
shown in the syntax line above. 

CP/M-68K supports four file Access Modes: 

RO The file has the Read-Only attribute that allows data to 

come from the file, but the file cannot be altered. 

RW The file has the Read-Write attribute that allows data to 

move either to or from the file. 

SYS The file has the System attribute. System files do not appear 

in DIR (directory) displays. Use DIRS to show System (SYS) 
files. Use the STAT command to display all files including 
those with the System attribute. The STAT command shows 
system files in parentheses. 

DIR The file has the Directory attribute and appears in DIR 

(directory) displays. 
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A file has either the RO or RW attribute, and either the SYS or DIR 
attribute. By default, and unless changed by the STAT command, a file 
has the RW and DIR attributes. 

This format for the STAT command produces a list of file characteris- 
tics under five headings: 

■ The first column displays the number of records used by the file, 
where each record is 128 bytes in length. This value is listed on your 
screen under the column marked Recs. 

■ The second column displays the number of kilobytes used by the file, 
where each kilobyte contains 1,024 bytes. This value is listed under 
Bytes. 

■ The third column displays the number of directory entries used by 
the file. This value appears under the FCBs column. FCB (File Con- 
trol Block) is another name for a directory entry. 

■ The Access Modes are displayed under the Attributes column. 

■ The file specification, consisting of the drive specifier, filename, and 
filetype of the file appears under Name on your screen. 

Use SIZE to tell STAT to compute the virtual file size of each file. The 
virtual and real file size are identical for sequential files, but can differ 
for files written in random mode. When you use SIZE, the additional 
column, marked Size, is displayed on the screen. The value in this 
column represents the number of filled and unfilled records allotted to 
the file. 

When you enter the command STAT *.*, STAT performs a directory 
verification to ensure that two files do not share the same disk space 
allocation. This means that the indicated file shares a portion of the 
disk with another file in the directory. If STAT finds a duplicate space 
allocation it displays the following message: 

Bad Directory on d: 

Space Allocation Conflict: 

User nn d: f i 1 e n a m e ♦ t y p 
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STAT prints the user number and the name of the file containing dou- 
bly allocated space. More than one file can be listed. The recommended 
solution is to erase the listed files, and then type a CTRL-C. 

STAT does a complete directory verification whenever a wildcard char- 
acter appears in the command tail. 

Examples: A>STflT MY#i# 

This command tells STAT to display the characteristics of all files that 
begin with the letters MY, with any filetype at all. Assume that the 
following three files satisfy the file specification. The screen could dis- 
play the following: 



Drive 


B: 








User 




Recs 


Bytes 


FCBs 


Attributes 




Name 




IB 


2K 


1 


Dir RW 


B: 


iMYPROG 


,A8S 


e 


IK 


1 


Di r RO 


B: 


:MYTEST 


♦ DAT 


32 


18K 


2 


Sys RO 


B: 


iMYTRAN 


♦ CMD 


Total: 


: 21K 













B: RW > Free Space: 90K 

A>sr/?r MY*,* SIZE 

This command causes the same action as the previous command, but 
includes the Size column in the display. Assume that MYFILE.DAT was 
written using random access from record number 8 through 15, leaving 
the first 8 records empty. The virtual file size is 16 records, although 
the file only consumes eight records. The screen appears as follows: 



Drive 


B: 










User 





Size 


Recs 


Bytes 


FCBs 


Att ributes 




Name 




IB 


16 


2K 


1 


Dir RW 


B: 


:MYPR0G 


,A86 


16 


8 


IK 


1 


Di r RO 


B: 


iMYTEST 


♦ DAT 


32 


32 


18K 


2 


Sys RO 


B: 


iMYTRAN 


'.CMD 



Total: 21K 4 
B: RW f Free Space: 90K 
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Set File Access Modes (Attributes) 

Syntax: STAT filespec RO |RW |SYS |DIR 

Explanation: This form of the STAT command lets you set the Access Mode for one 
or more files. Note that the option following filespec can be enclosed 
in square brackets [ ], be preceded by a dollar sign $ or by no delimiter 
as shown above. 

The four Access Modes, described above, are 

RO 
RW 
SYS 
DIR 

A file can have either the RO or RW Access Mode, but not both. 
Similarly, a file can have either the SYS or DIR Access Mode, but not 
both. 

Examples: b>STATLET TER , TX T RO 

This command sets the Access Mode for the file LETTER.TXT on the 
default drive to RO. The following message appears on your screen if 
the file is present: 

LETTER.TXT set to RO 

The command: 

B>srar a-.**g8k sys 

sets the Access Mode for all files on drive A, with filetype 68K, to SYS. 
Given that the three command files PIP, ED, and STAT are present on 
drive A, the following message appears on your screen: 

PIP.G8K set to SYS 
ED.G8K set to SYS 
STAT.G8K set to SYS 
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Display Disk Status 

Syntax: STAT {d:}DSK: 

Explanation: This form of the STAT command displays internal information about 
your disk system for all on-line disks. The information provided by this 
command is useful for more advanced programming, and is not neces- 
sary for your everyday use of CP/M-68K. 

Examples: b>STAT DSK: 

This STAT command displays information about drive A in the follow- 
ing form. STAT supplies numbers for n. 

A: Drive Characteristics 

nnnn: 128 Byte Record Capacity 

nnnn: Kilobyte Drive Capacity 

nnnn: 32 Byte Directory Entries 

nnnn: Checked Directory Entries 

nnnn: 128 Byte Records/Directory Entry 

nnnn: 128 Byte Records/Block 

nnnn: 128 Byte Records/Track 

nnnn: Reserved Tracks 

b>STAT B-.DSK: 

This command produces the information shown in the previous exam- 
ple for drive B. 

Display User Numbers with Active Files 

Syntax: STAT {d:}USR: 

Explanation: This form of the STAT command lets you determine the user numbers 
that have files on the disk in the specified drive. 
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User numbers are assigned to files that are created under CP/M-68K. 
Use this form of the STAT command to determine the active user num- 
bers on a disk. 

Examples: A > S 77) 7 USR : 

This command displays the user numbers containing active files on the 
disk in drive A. 

Display STAT Commands and Device Names 

Syntax: STAT VAL: 

Explanation: STAT VAL: displays the general form of the STAT commands. It also 
displays the possible physical device names that you can assign to each 
of the four CP/M-68K logical device names. 

Examples: The STAT VAL: display is shown below: 

A>S77)r ML: 

Set Attribute: d:filename.typ [ro] [rw] [sys] [dir] 

Disk Status : DSK: d:DSK: 

User Status : USR: d:USR: 

IObyte Assign: 

CON: = TTY: CRT: BAT: UC1: 

AXI: = TTY: PTR: UR1: UR2: 

AXO: = TTY: PTP: UP1: UP2: 

LST: = TTY: CRT: LPT: UL1: 

A> 
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Display and Set Physical to Logical Device Assignments 

Syntax: STAT DEV: 

STAT logical device: = physical device: 

Explanation: STAT DEV: displays the current assignments for the four CP/M-68K 
logical device names: CON:, RDR:, PUN:, and LST:. Use the second 
form of the above STAT command to change these current assign- 
ments. The command STAT VAL: displays the possible physical device 
names that you can assign to each logical device name. Refer to the 
part of the STAT VAL: display entitled, IObyte Assign, shown above. 

When you assign a physical device to a logical device, STAT assigns a 
value from to 3 to the logical device name in what is called the 
IObyte. 

You can assign any of the listed physical device names to their appro- 
priate logical device names. However, the assignment does not work 
unless you are using the proper Input/Output (I/O) Port on your com- 
puter, with the proper cable to connect the computer to the device, and 
the proper I/O driver routine for the particular physical device. This 
facility must be supported by the manufacturer of your computer before 
the physical-to-logical assignments can be meaningful. 

Examples: f\>STAT CON : = CRT: 

The command above assigns the physical device name CRT: to the 
logical input device name CON:, which generally refers to the console. 

A>S77*r LST: = LPT: 

The command above assigns the physical device name LPT: to the 
logical output device name LST:, which generally refers to the list device 
of the printer. 
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The SUBMIT (Batch Processing) Command 

Syntax: {SUBMIT} {filespec (argumentl... argument9)} 

Explanation: The SUBMIT command lets you execute a group or batch of com- 
mands from a SUB file, which is a file with a filetype of SUB. 

Usually you enter commands one line at a time. If you must enter the 
same sequence of commands several times, you might find it easier to 
batch the commands together using the SUBMIT command. To do this, 
you create a file and enter your commands in this file. The file is iden- 
tified by the filename, and must have a filetype of SUB. When you issue 
the SUBMIT command, SUBMIT reads the file named by the filespec 
and prepares it for interpretation by CP/M-68K. When the preparation 
is complete, SUBMIT sends the file to CP/M-68K line-by-line, as if you 
were typing each command. 

Example: The following sample lines illustrate some of the variety of commands 
that can be entered in a SUB file: 

DIR 

DIR*.BAK 

ERA*.BAK 

PIP LST:=$1,PRN[T$2$3$4] 

DIRS*.G8K 

PIPA:*.LTR 

DIR B: 
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Creating the SUB File 

Explanation: The SUB file can contain any valid CP/M-68K command or any valid 
CP/M-68K command with SUBMIT parameters. You can even refer- 
ence other SUB files in a SUB file. Embedded files of this kind are 
treated as chained files, not nested files. That is, any commands follow- 
ing an embedded SUB file will be ignored; a SUB file called by another 
SUB file never returns to the caller after successful execution. For that 
reason, the last line in a SUB file is the only useful place for an embed- 
ded SUB file. 

If the embedded SUB file cannot be executed, CP/M-68K branches around 
the nonexecutable SUB file and tries to execute those commands 
appearing below the embedded SUB file. 

You can put more than one command on a line if you separate each 
command with an exclamation mark. For example, 

ERA*.BAK !DIR*.G8K! PIP$1 :=$2:$3Cu] 

contains three distinct CP/M-68K commands on one line of a SUBMIT 
file. The length of any command must not exceed 128 characters. 

You can create the SUB file with the ED utility, with some other editor, 
or with a word processing program. 

You can pass arguments to SUB files when you execute them. Each 
argument you enter is assigned to a parameter in the SUB file. The first 
argument replaces every occurrence of $1 in the file, the second argu- 
ment replaces parameter $2, etc., up to parameter $9. For example, if 
your file START.SUB contains the following commands: 

ERA $1.BAK 

DIR $1 

PIP A:$l .=A:$2.68K 

PIP A:FINISH.SUB=A:$O.SUB 
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and you enter the following SUBMIT command: 

A> SUBMIT START SAM TEX 

SUBMIT substitutes these actual parameters for the symbolic stand-in 
parameters in your START.SUB file as sequential execution occurs. In 
this example, the argument SAM is substituted for every $1 in the 
START.SUB file as sequential execution occurs, TEX is substituted for 
every occurrence of $2 in the START.SUB file, and START is substi- 
tuted for $0. As each line is encountered in your SUB file, SUBMIT 
then executes this file, line-by-line. The substitutions look like this to 
SUBMIT: 

ERA SAM.BAK 

DIR SAM 

PIP A:SAM=A:TEX.G8K 

PIP A:FIIMISH.SUB = START.SUB 

If you enter fewer arguments in the SUBMIT command than there are 
parameters in the SUB file, the extra parameters are not used. 

If you enter more arguments in the SUBMIT command than there are 
parameters in the SUB file, the extra arguments are ignored. 

To include an actual dollar sign $ in your SUB file, type two dollar 
signs in a row, $$. SUBMIT replaces them with a single dollar sign. 
For example, if you have a file SEARCH.SUB and it contains the line: 

DIR, $1 :*,$$$$$$ 

and you enter the following SUBMIT command, 

A> SUBMIT SEARCH B 

then the translated file contains the following: 

DIR B:*.$$$ 

The net effect in this example is that CP/M-68K looks for all files on 
drive B that have the filetype of $$$. 
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Executing the SUBMIT Command 

To appreciate how SUBMIT is executed, recall the syntax mentioned 
earlier: 

Syntax: {SUBMIT} {filespec (argumentl... argument9)} 

Explanation: Based on the above syntax, there are five ways of executing a SUBMIT 
command before the parameter list is evaluated: 

SUBMIT filename.SUB 

SUBMIT filename 

filename.SUB 

filename 

SUBMIT 

If the first form is used, CP/M-68K first looks in your current user area 
for the filename you typed with the filetype of SUB. If that file specifi- 
cation is found there, SUBMIT tries to execute the file. If it is not found 
in your current user area, CP/M-68K then searches user area for 
filename.SUB. If it is not found in either user area, CP/M-68K displays 
on your console the message: 

♦ SUB file not found 

If the second form is used, CP/M-68K appends the SUB filetype to your 
filename and searches for that file specification in your current user 
area, then in user 0, if need be. If that file specification is found, SUB- 
MIT tries to execute the file. If it is not found, CP/M-68K displays on 
your console the message: 

SUB file not found 

If the third form is used, CP/M-68K assumes you want to invoke the 
SUBMIT command because you supplied the SUB filetype. If that file 
specification is found in your current user area (or user 0, if need be), 
SUBMIT tries to execute the file. If it is not found, CP/M-68K displays 
on your console your filename with a question mark after it. 
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If the fourth form is used, the general rules of file searching as set forth 
in Section 4.2 take precedence as shown in the following three steps: 

1. CP/M-68K assumes you are trying to invoke a program file in your 
current user area, but CP/M-68K does not assume you supplied a 
filetype. Therefore, CP/M-68K first appends a filetype of 68K to 
your filename and searches your current user area for the file. If 
filename.68K is found, CP/M-68K executes that file without invok- 
ing SUBMIT. 

2. If filename.68K is not found, CP/M-68K substitutes a blank filetype 
for the 68K filetype it appended to your filename and searches for 
this file specification in your current user area. If such a file exists, 
it is executed and SUBMIT is again bypassed. 

3. If the file specification with the blank filetype is not found, 
CP/M-68K substitutes a SUB filetype for the blank filetype and 
searches for this file specification in your current user area. If file- 
name.SUB is found, CP/M-68K recognizes that you want to execute 
a SUBMIT file; control passes to SUBMIT and SUBMIT tries to 
execute your file. 

4. If CP/M-68K is unable to find any of the above combinations in 
your current user area, it searches user area first for your file- 
name.68K, then for your filename.<blank>, and finally for your 
filename.SUB. If none of these three file specifications are found in 
either the current user area or user area 0, CP/M-68K displays the 
command keyword followed by a question mark. 

If the fifth form is used, CP/M-68K prompts you for your file 
specification: 

Enter Fi lename : _ 

The underscore represents your cursor's position. You may then reply 
with a filename having a blank filetype or with a filename having a 
filetype of SUB. If you provide a blank filetype, CP/M-68K appends the 
SUB filetype for you. If you provide any filetype other than SUB or 
blank, CP/M-68K rejects it as inappropriate for SUBMIT and asks you 
to supply a filename with a filetype of SUB or blank. 
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If you enter only SUBMIT, the system prompts for the rest of the 
command. You enter the filespec and arguments. 

Example: A> SUBMIT 

and the system prompts: 

Enter Filename: 

Enter the filespec and arguments here, such as 

START B TEX 

Another example could be: 

A> SUBMIT SUB d 
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The TYPE (Display File) Built-in 

Syntax: TYPE {filespec} 

Explanation: The TYPE built-in command displays the contents of a character file 
on your screen. If the file occupies more than a screenful of space, 
TYPE scrolls the file vertically up the screen. Press CTRL-S to stop the 
scrolling and CTRL-Q to resume. Wildcards are not permitted with 
this command. 

Tab characters occurring in the file named by the file specification are 
expanded to every eighth column position of your screen. 

To abort the TYPE command while text is scrolling on your screen, 
press CTRL-C. 

Make sure the file specification identifies a file containing character 
data. 

Examples: A > TYPE MYPR0G.A8B 

This command displays the contents of the file MYPROG.A86 on your 
screen. 

A>7TPE B:THISFILE 

This command displays the contents of the file THISFILE from drive B 
on your screen. 

TYPE can also be executed without first specifying the file specification 
in the command line. If you do this, TYPE prompts you for your file 
specification: 

Enter Filename: _ 

The underscore represents your cursor's position. Respond with the file 
specification of the file whose contents you want to see displayed on 
your screen. 
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If the file named by the file specification is not present on an on-line 
disk, TYPE displays the following message on your screen: 

NO FILE 

To list the file at the printer as well as on the screen, type a CTRL-P 
before entering the TYPE command line. To stop echoing keyboard 
input at the printer, type a second CTRL-P. 
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The USER (Set User Number) Command 



Syntax: USER {number} 

Explanation: The USER command sets the current user number. The disk directory 
can be divided into distinct groups according to a user number. User 
numbers range from through 15. 

When CP/M-68K starts, is the current user number. Executable files 
created under user are accessible from any other user number. Files 
that you create under any user number other than are not accessible 
under any other user number, except through the PIP command. See 
the G option of the PIP command. 



Example: 



f\>USER 3 
3A> 



This command changes the current user number to 3. 

USER can also be executed without specifying the user number in the 
command line. If you do this, USER prompts you for your user new 
number. 

Example: A>L/SE/? 

Enter User No ♦ : _ 

The underscore represents your cursor's position. Respond with the 
user number you wish to make current: 

Ent e r User No ♦ : 5 
5A> 

The current user number is now 5 on drive A. 



End of Section S 
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The CP/M-68K Editor 



6.1 Introduction to ED 

To do almost anything with a computer you need some way to enter data, some 
way to give the computer the information you want it to process. The programs most 
commonly used for this task are called editors. They transfer your keystrokes at the 
keyboard to a disk file. CP/M-68K's editor is named ED. Using ED, you can easily 
create and alter CP/M-68K text files. 

The correct command syntax for invoking the CP/M-68K editor is given in 
Section 6.2, "Starting ED." After starting ED, you issue commands that transfer text 
from a disk file to memory for editing. "ED Operation" details this operation and 
describes the basic text transfer commands that allow you to easily enter and exit the 
editor. 

Section 6.4, "Basic Editing Commands," details the commands that edit a file. 
Section 6.5, "Combining ED Commands," describes how to combine the basic com- 
mands to edit more efficiently. Although you can edit any file with the basic ED 
commands, ED provides several more commands that perform more complicated 
editing functions, as described in Section 6.6, "Advanced ED Commands." 

During an editing session, ED may return two types of error messages. Section 6.7, 
"ED Error Messages," lists these messages and provides examples that indicate how 
to recover from common editing error conditions. 
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6.2 Starting ED 

Syntax: 

ED filespec filespec 

To start ED, enter its name after the CP/M-68K prompt. The command ED must 
be followed by a file specification, one that contains no wildcard characters, such as: 

f\>ED MYFILE.TEX 

The file specification, MYFILE.TEX in the above example, specifies a file to be 
edited or created. The file specification can be preceded by a drive specifier but a 
drive specifier is unnecessary if the file to be edited is on your default drive. Option- 
ally, the file specification can be followed by a drive specifier, as shown in the 
following example. 

A>ED MYFILE.TEX B: 

In response to this command, ED opens the file to be edited, MYFILE.TEX, on 
drive A, but sends all the edited material to a file on drive B. 

Optionally, you can send the edited material to a file with a different filename, as 
shown in the following example. 

A > ED MYFILE, TEX YOURF ILE* TEX 

The file with the different filename cannot already exist or ED prints the following 
message and terminates. 

Output File Exists* Erase It 

The ED prompt, *, appears at the screen when ED is ready to accept a command, as 
shown below. 

A>£D MYFILE. TEX 
: * 
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If no previous version of the file exists on the current disk, ED automatically 
creates a new file and displays the following message: 

NEW FILE 
: * 

Note: before starting an editing session, use the STAT command to check the amount 
of free space on your disk. Make sure that the unused portion of your disk is at least 
as large as the file you are editing or larger if you plan to add characters to the file. 
When ED finds a disk or directory full, ED has only limited recovery mechanisms. 
These are explained in Section 6.7, "ED Error Messages." 



6.3 ED Operation 

With ED, you change portions of a file that pass through a memory buffer. When 
you start ED with one of the commands shown above, this memory buffer is empty. 
At your command, ED reads segments of the source file, for example MYFILE.TEX, 
into the memory buffer for you to edit. If the file is new, you must insert text into 
the file before you can edit. During the edit, ED writes the edited text onto a tempo- 
rary work file, MYFILE.5 



When you end the edit, ED writes the memory buffer contents to the temporary 
file, followed by any remaining text in the source file. ED then changes the name of 
the source file from MYFILE.TEX to MYFILE.BAK, so you can reclaim this original 
material from the back-up file if necessary. ED then renames the temporary file, 
MYFILE.$$$, to MYFILE.TEX, the new edited file. The following figure illustrates 
the relationship between the source file, the temporary work file and the new file. 

Note: when you invoke ED with two filespecs, an input file and an output file, ED 
does not rename the input file to type .BAK; therefore, the input file can be Read- 
only or on a write-protected disk if the output file is written to another disk. 
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Figure 6-1. Overall ED Operation 



In Figure 6-1, the memory buffer is logically between the source file and the 
temporary work file. ED supports several commands that transfer lines of text between 
the source file, the memory buffer, and the temporary (and eventually final) file. The 
following table lists the three basic text transfer commands that allow you to easily 
enter the editor, write text to the temporary file, and exit the editor. 
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Table 6-1. Text Transfer Commands 



Command 



Result 



nA Append the next n unprocessed source lines from the source file 

to the end of the memory buffer. 

nW Write the first n lines of the memory buffer to the temporary 

file free space. 

E End the edit. Copy all buffered text to the temporary file, and 

copy all unprocessed source lines to the temporary file. Rename 
files. 



6.3.1 Appending Text into the Buffer 

When you start ED and the memory buffer is empty, you can use the A (append) 
command to add text to the memory buffer. 

Note: ED can number lines of text to help you keep track of data in the memory 
buffer. The colon that appears when you start ED indicates that line numbering is 
turned on. Type -V after the ED prompt to turn the line number display off. Line 
numbers appear on the screen but never become a part of the output file. 

The A (Append) Command 

The A command appends (copies) lines from an existing source file into the mem- 
ory buffer. The form of the A command is 

nA 

where n is the number of unprocessed source lines to append into the memory buffer. 
If a pound sign, #, is given in place of n, then the integer 65535 is assumed. Because 
the memory buffer can contain most reasonably sized source files, it is often possible 
to issue the command #A at the beginning of the edit to read the entire source file 
into memory. 

If n is 0, ED appends the unprocessed source lines into the memory buffer until 
the buffer is approximately half full. If you do not specify n, ED appends one line 
from the source file into the memory buffer. 
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6.3.2 ED Exit 

You can use the W (Write) command and the E (Exit) command to save your 
editing changes. The W command writes lines from the memory buffer to the new 
file without ending the ED session. An E command saves the contents of the buffer 
and any unprocessed material from the source file and exits ED. 

The W (Write) Command 

The W command writes lines from the buffer to the new file. The form of the W 
command is 

nW 

where n is the number of lines to be written from the beginning of the buffer to the 
end of the new file. If n is greater than 0, ED writes n lines from the beginning of 
the buffer to the end of the new file. If n is 0, ED writes lines until the buffer is half 
empty. The 0W command is a convenient way of making room in the memory buffer 
for more lines from the source file. You can determine the number of lines to write 
out by executing a 0V command to check the amount of free space in the buffer, as 
shown below: 

Is *CH> 
25000/30000 
1: * 

The above display indicates that the total size of the memory buffer is 30,000 bytes 
and there are 25,000 free bytes in the memory buffer. 

Note: after a W command is executed, you must enter the H command to reedit 
the saved lines during the current editing session. 

The E (Exit) Command 

An E command performs a normal exit from ED. The form of the E command is 

E 

followed by a carriage return. 
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When you enter an E command, ED first writes all data lines from the buffer and 
the original source file to the new file. If a .BAK file exists, ED deletes it, then 
renames the original file with the .BAK filetype. Finally, ED renames the new file 
from filename.$$$ to the original filetype and returns control to the CCP. 

The operation of the E command makes it unwise to edit a back-up file. When you 
edit a BAK file and exit with an E command, ED erases your original file because it 
has a .BAK filetype. To avoid this, always rename a back-up file to some other 
filetype before editing it with ED. 

Note: any command that terminates an ED session must be the only command on 
the line. 



6.4 Basic Editing Commands 

The text transfer commands discussed above allow you to easily enter and exit the 
editor. This section discusses the basic commands that edit a file. 

ED treats a file as a long chain of characters grouped together in lines. ED displays 
and edits characters and lines in relation to an imaginary device called the character 
pointer (CP). During an edit session, you must mentally picture the CP's location in 
the memory buffer and issue commands to move the CP and edit the file. 

The following commands move the character pointer or display text in the vicinity 
of the CP. These ED commands consist of a numeric argument and a single com- 
mand letter and must be followed by a carriage return. The numeric argument, n, 
determines the number of times ED executes a command; however, there are four 
special cases to consider in regard to the numeric argument: 

■ If the numeric argument is omitted, ED assumes an argument of 1. 

■ Use a negative number if the command is to be executed backwards through 
the memory buffer. (The B command is an exception). 

■ If you enter a pound sign, #, in place of a number, ED uses the value 65535 
as the argument. A pound sign argument can be preceded by a minus sign to 
cause the command to execute backwards through the memory buffer ( — #). 

■ ED accepts as a numeric argument only in certain commands. In some cases, 
causes the command to be executed approximately half the possible number 
of times, while in other cases it prevents the movement of the CP. 
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The following table alphabetically summarizes the basic editing commands and 
their valid arguments. 



Table 6-2. Basic Editing Commands 



Command 


Action 


B,-B 


Move CP to the beginning (B) or end( — B) of the memory buffer. 


nc, — nC 


Move CP n characters forward (nC) or backward ( — nC) through 
the memory buffer. 


nD,-nD 


Delete n characters before ( — nD) or after (nD) the CP. 


I 


Enter insert mode. 


Istring f Z 


Insert a string of characters. 


nK,-nK 


Delete (kill) n lines before the CP ( - nK) or after the CP (nK). 


nL, — nL 


Move the CP n lines forward (nL) or backward ( — nL) through 
the memory buffer. 


nT, — nT 


Type n lines before the CP ( — nT) or after the CP (nT). 


n, -n 


Move the CP n lines before the CP( — n)or after the CP (n) and 
display the destination line. 



The following sections discuss ED's basic editing commands in more detail. The 
examples in these sections illustrate how the commands affect the position of the 
character pointer in the memory buffer. Later examples in Section 6.5, "Combining 
ED Commands," illustrate how the commands appear at the screen. For these sec- 
tions, however, the symbol A in command examples represents the character pointer, 
which you must imagine in the memory buffer. 
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6.4.1 Moving the Character Pointer 

This section describes commands that move the character pointer in useful incre- 
ments but do not display the destination line. Although ED is used primarily to 
create and edit program source files, the following sections present a simple text as 
an example to make ED easier to learn and understand. 

The B (Beginning/Bottom) Command 

The B command moves the CP to the beginning or bottom of the memory buffer. 
The forms of the B command are 

B,-B 

— B moves the CP to the end or bottom of the memory buffer; B moves the CP to the 
beginning of the buffer. 

The C (Character) Command 

The C command moves the CP forward or backward the specified number of 
characters. The forms of the C command are 

nC, — nC 

where n is the number of characters the CP is to be moved. A positive number moves 
the CP towards the end of the line and the bottom of the buffer. A negative number 
moves the CP towards the beginning of the line and the top of the buffer. You can 
enter an n large enough to move the CP to a different line. However, each line is 
separated from the next by two invisible characters: a carriage return and a line-feed 
represented by <cr><lf>. You must compensate for their presence. For example, 
the command 30C moves the CP to the next line: 

Emily Dickinson said,<cr><lf> 

"I fin'd ecstasy in living — <cr><lf> 



EH DIGITAL RESEARCH™ 

6-9 



6.4 Basic Editing Commands CP/M-68K User's Guide 

The L (Line) Command 

The L command moves the CP the specified number of lines. After an L command, 
the CP always points to the beginning of a line. The forms of the L command are 

nL, — nL 

where n is the number of lines the CP is to be moved. A positive number moves the 
CP towards the end of the buffer. A negative number moves the CP back toward the 
beginning of the buffer. The command 2L moves the CP two lines forward through 
the memory buffer and positions the character pointer at the beginning of the line. 

Emily Dickinson said,<cr><lf> 
"I find ecstasy in living — <cr><lf> 
"the mere sense of living<cr><lf> 

The command — L moves the CP to the beginning of the previous line, even if the CP 
originally points to a character in the middle of the line. Use the special character 
to move the CP to the beginning of the current line. 

The n (Number) Command 

The n command moves the CP and displays the destination line. The forms of the 
n command are, 

n, — n 

where n is the number of lines the CP is to be moved. In response to this command, 
ED moves the CP forward or backward the number of lines specified, then prints 
only the destination line. 

Emily Dickinson said,<cr><lf> 

*"I find ecstasy in living — <cr><lf> 

A further abbreviation of this command is to enter no number at all. In response to 
a carriage return without a preceding command, ED assumes an n command of 1 
and moves the CP down to the next line and prints it. 

Emily Dickinsonn said,<cr><lf> 
A "I find ecstasy in living — <cr><lf> 
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Also, a minus sign, - , without a number moves the CP back one line. 

6.4.2 Displaying Memory Buffer Contents 

ED does not display the contents of the memory buffer until you specify which 
part of the text you want to see. The T command displays text without moving the 
CP. 

The T (Type) Command 

The T command types a specified number of lines from the CP at the screen. The 
forms of the T command are 

nT, — nT 

where n specifies the number of lines to be displayed. If a negative number is entered, 
ED displays n lines before the CP. A positive number displays n lines after the CP. If 
no number is specified, ED types from the character pointer to the end of the line. 
The CP remains in its original position no matter how many lines are typed. For 
example, if the character pointer is at the beginning of the memory buffer, and you 
instruct ED to type four lines (4T), four lines are displayed at the screen, but the CP 
stays at the beginning of line 1. 

"Emily Dickinson said,<cr><lf> 
"I find ecstasy in living — <cr><lf> 
the mere sense of living is 
joy enough." <cr><lf> 

If the CP is between two characters in the middle of the line, T command with no 
number specified types only the characters between the CP and the end of the line, 
but the character pointer stays in the same position, as shown in the memory buffer 
example below. 

"I find ec'stasy in living — 

Whenever ED is displaying text with the T command, you can enter a CTRL-S to 
stop the display, then a CTRL-Q when you're ready to continue scrolling. Enter a 
CTRL-C to abort long type-outs. 
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6.4.3 Deleting Characters 

The D (Delete) Command 

The D command deletes a specified number of characters and has the forms: 

nD,-nD 

where n is the number of characters to be deleted. If no number is specified, ED 
deletes the character to the right of the CP. A positive number deletes multiple 
characters to the right of the CP, towards the bottom of the file. A negative number 
deletes characters to the left of the CP, towards the top of the file. If the character 
pointer is positioned in the memory buffer as shown below: 

Emily Dickinson said,<cr><lf> 
"I find ecstasy in living — <cr><lf> 
the mere sense of living<cr><lf> 
is joy "enough."<cr><lf> 

the command 6D deletes the six characters after the CP, and the resulting memory 
buffer looks like this: 

Emily Dickinson said,<cr><lf> 
"I find ecstasy in living — <cr><lf> 
the mere sense of living<cr><lf> 
is joy Y'<crXlf> 

You can also use a D command to delete the <cr><lf> between two lines to join 
them together. Remember that the <cr> and <lf> are two characters. 

The K (Kill) Command 

The K command kills or deletes whole lines from the memory buffer and takes the 
forms: 

nK,-nK 
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where n is the number of lines to be deleted. A positive number kills lines after the 
CP. A negative number kills lines before the CP. When no number is specified, ED 
kills the current line. If the character pointer is at the beginning of the second line 
(as shown below), 

Emily Dickinson said,<cr><lf> 
A "I find ecstasy in living — <cr><lf> 
the mere sense of living<cr><lf> 
is joy enough. "<cr><lf> 

then the command -K deletes the previous line and the memory buffer changes: 

A "I find ecstasy in living — <cr><lf> 
the mere sense of living<cr><lf> 
is joy enough." <cr><lf> 

If the CP is in the middle of a line, a K command kills only the characters from 
the CP to the end of the line and concatenates the characters before the CP with the 
next line. A — K command deletes all the characters between the beginning of the 
previous line and the CP. An OK command deletes the characters on the line up to 
the CP. 

You can use the special # character to delete all the text from the CP to the 
beginning or end of the buffer. Be careful when using #K because you cannot reclaim 
lines after they are removed from the memory buffer. 

6.4.4 Inserting Characters into the Memory Buffer 

The I (Insert) Command 

To insert characters into the memory buffer from the screen, use the I command. 
The I command takes the forms: 

I 
Istring'Z 
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When you type the first command, ED enters insert mode. In this mode, all key- 
strokes are added directly to the memory buffer. ED enters characters in lines and 
does not start a new line until you press the enter key. 

A>£D B: QUOTE* TEX 



NEW FILE 

: *i 

1 : Emily Dickinson sai d * 

2 : "I find ecstasy in living - 

3: the mere sense of living 

4: is Joy enough ♦ " 

5: *Z 



Note: to exit from insert mode, you must press CTRL-Z or Esc. When the ED 
prompt, *, appears on the screen, ED is not in insert mode. 

In command mode, you can use CP/M-68K line editing control characters to edit 
your input. The table below lists these control characters. 





Table 6-3. CP/M-68K Line Editing Controls 


Command 


Result 


CTRL-C 


Abort the editor and return to the CP/M-68K system. 


CTRL-E 


Return carriage for long lines without transmitting command 
line to the buffer. 


CTRL-H 


Delete the last character typed on the current line. 


CTRL-U 


Delete the entire line currently being typed. 


CTRL-X 


Delete the entire line currently being typed. Same as CTRL-U. 


Rubout 


Remove the last character and echo deleted character at the 




screen. 
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Note: in insert mode, the same line editing controls exist except for CTRL-C and 
CTRL-E. 

When entering a combination of numbers and letters, you might find it inconven- 
ient to press a caps-lock key if your terminal translates caps-locked numbers to 
special characters. ED provides two ways to translate your alphabetic input to upper- 
case without affecting numbers. The first is to enter the insert command letter in 
upper-case: I. All alphabetics entered during the course of the capitalized command, 
either in insert mode or as a string, are translated to upper-case. (If you enter the 
insert command letter in lower-case, all alphabetics are inserted as typed). The sec- 
ond method is to enter a U command before inserting text. Upper-case translation 
remains in effect until you enter a -U command. 

The Istring'Z (Insert String) Command 

The second form of the I command does not enter insert mode. It inserts the 
character string into the memory buffer and returns immediately to the ED prompt. 
You can use CP/M-68K's line editing control characters to edit the command string. 

To insert a string, first use one of the commands that position the CP. You must 
move the CP to the place where you want to insert a string. For example, if you 
want to insert a string at the beginning of the first line, use a B command to move 
the CP to the beginning of the buffer. With the CP positioned correctly, enter an 
insert string, as shown below: 

iln 1870» A Z 

This inserts the phrase "In 1870," at the beginning of the first line, and returns 
immediately to the ED prompt. In the memory buffer, the CP appears after the inserted 
string, as shown below: 

In 1870, "Emily Dickinson said,<cr><lf> 
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6.4.5 Replacing Characters 

The S (Substitute) Command 

The S command searches the memory buffer for the specified string, but when it 
finds it, automatically substitutes a new string for the search string. The S command 
takes the form: 

nSsearch string'Znew string 

where n is the number of substitutions to make. If no number is specified, ED 
searches for the next occurrence of the search string in the memory buffer. For 
example, the command: 

Emily Di cK iinson A ZThe poet 

searches for the first occurrence of Emily Dickinson and substitutes The poet. 
In the memory buffer, the CP appears after the substituted phrase, as shown below: 

The poet" said,<cr><lf> 

If upper-case translation is enabled by a capital S command letter, ED looks for a 
capitalized search string and inserts a capitalized insert string. Note that if you com- 
bine this command with other commands, you must terminate the new string with a 
CTRL-Z. 



6.5 Combining ED Commands 

It saves keystrokes and editing time to combine the editing and display commands. 
You can type any number of ED commands on the same line. ED executes the 
command string only after you press the carriage-return key. Use CP/M-68K's line 
editing controls to manipulate ED command strings. 
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When you combine several commands on a line, ED executes them in the same 
order they are entered, from left to right on the command line. There are four 
restrictions to combining ED commands: 

■ The combined-command line must not exceed CP/M-68K's 128 character 
maximum. 

■ If the combined-command line contains a character string, the line must not 
exceed 100 characters. 

■ Commands to terminate an editing session must not appear in a combined- 
command line. 

■ Commands, such as the I, J, R, S, and X commands, that require character 
strings or filespecs must be either the last command on a line or must be 
terminated with a CTRL-Z or Esc character, even if no character string or 
filespec is given. 

While the examples in the previous section show the memory buffer and the posi- 
tion of the character pointer, the examples in this section show how the screen looks 
during an editing session. Remember that the character pointer is imaginary, but you 
must picture its location because ED's commands display and edit text in relation to 
the character pointer. 

6.5.1 Moving the Character Pointer 

To move the CP to the end of a line without calculating the number of characters, 
combine an L command with a C command, L-2C. This command string accounts 
for the <cr><lf> sequence at the end of the line. 

Change the C command in this command string to move the CP more characters 
to the left. You can use this command string if you must make a change at the end 
of the line and you don't want to calculate the number of characters before the 
change, as in the following example: 



1: 


*T 






1: 


Emily Die! 


Vinson 


said > 


1: 


*L-7CT 






said* 








1: 


# 
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6.5.2 Displaying Text 

A T command types from the CP to the end of the line. To see the entire line, you 
can combine an L command and a T command. Type Olt to move the CP from the 
middle to the beginning of the line and then display the entire line. In the example 
below, the CP is in the middle of the line. OL moves the CP to the beginning of the 
line. T types from the CP to the end of the line, allowing you to see the entire line. 



3 
sense 
3 
3 
3 



*7 
of liuina 
*OLT 

the mere 
# 



sense of living 



The command OTT displays the entire line without moving the CP. 

To verify that an ED command moves the CP correctly, combine the command 
with the T command to display the line. The following example combines a C 
command and a T command. 

2: *8CT 
ecstasy in living - 
2: * 



*B#T 
Emily DicKinson said* 
"I find ecstasy in 1 i u i n 3 
the mere sense of living 
is Jov enough." 

# 



6.5.3 Editing 

To edit text and verify corrections quickly, combine the edit commands with other 
ED commands that move the CP and display text. Command strings like the one 
below move the CP, delete specified characters, and verify changes quickly. 

1: *15C5D0LT 

1 : Emi 1 y DicKinson* 

1: * 
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Combine the edit command K with other ED commands to delete entire lines and 
verify the correction quickly, as shown below. 



*2L2KB#T 
Emily DicKinson said* 
"I find ecstasy in living 

* 



The abbreviated form of the I (insert) command makes simple textual changes. To 
make and verify these changes, combine the I command string with the C command 
and the OLT command string as shown below. Remember that the insert string must 
be terminated by a CTRL-Z. 

1: *20Ci to a friend "ZQLT 

1: Emily DicKinson said to a friend* 

1: * 



6.6 Advanced ED Commands 

The basic editing commands discussed above allow you to use ED for all your 
editing. The following ED commands, however, enhance ED's usefulness. 

6.6.1 Moving the CP and Displaying Text 

The P (Page) Command 

Although you can display any amount of text at the screen with a T command, it 
is sometimes more convenient to page through the buffer, viewing whole screens of 
data and moving the CP to the top of each new screen at the same time. To do this, 
use ED's P command. The P command takes the following forms: 

nP,-nP 

where n is the number of pages to be displayed. If you do not specify n, ED types 
the 23 lines following the CP and then moves the CP forward 23 lines. This leaves 
the CP pointing to the first character on the screen. 

To display the current page without moving the CP, enter OP. The special character 
prevents the movement of the CP. If you specify a negative number for n, P pages 
backwards towards the top of the file. 
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The n: (Line Number) Command 

When line numbers are being displayed, ED accepts a line number as a command 
to specify a destination for the CP. The form for the line number command is 



where n is the number of the destination line. This command places the CP at the 
beginning of the specified line. For example, the command 4: moves the CP to the 
beginning of the fourth line. 

Remember that ED dynamically renumbers text lines in the buffer each time a line 
is added or deleted. Therefore, the number of the destination line you have in mind 
can change during editing. 

The :n (Through Line Number) Command 

The inverse of the line number command specifies that a command should be 
executed through a certain line number. You can use this command only with three 
ED commands: the T (type) command, the L (line) command, and the K (kill) com- 
mand. The :n command takes the following form: 

:ncommand 

where n is the line number through which the command is to be executed. The :n 
part of the command does not move the CP, but the command that follows it might. 

You can combine n: with :n to specify a range of lines through which a command 
should be executed. For example, the command 2::4T types the second, third, and 
fourth lines, as shown below. 



*2: :4T 
"I find ecstasy in 1 i u i n 3 
the mere sense of living" 
is Joy enough." 

# 
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6.6.2 Finding and Replacing Character Strings 

ED supports a find command, F, that searches through the memory buffer and 
places the CP after the word or phrase you want. The N command allows ED to 
search through the entire source file instead of just the buffer. The J command 
searches for and then juxtaposes character strings. 

The F (Find) Command 

The F command performs the simplest find function. Its form is 

nFstring 

where n is the occurrence of the string to be found. Any number you enter must be 
positive because ED can only search from the CP to the bottom of the buffer. If you 
enter no number, ED finds the next occurrence of the string in the file. In the follow- 
ing example, the second occurrence of the word living is found. 

1: *2f living 
3: * 

The character pointer moves to the beginning of the third line where the second 
occurrence of the word "living" is located. To display the line, combine the find 
command with a type command. Note that if you follow an F command with another 
ED command on the same line, you must terminate the string with a CTRL-Z, as 
shown below. 

1: *2flivin3 A Z01t 

3 : *the mere sense of living 

It makes a difference whether you enter the F command in upper- or lower-case. If 
you enter F, ED internally translates the argument string to upper-case. If you specify 
f, ED looks for an exact match. For example, FCp/m-68k searches for CP/M-68K 
but fCp/m-68k searches for Cp/m-68k and cannot find CP/M-68K, or cp/m-68K. 
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If ED does not find a match for the string in the memory buffer, it issues the 
message: 

BREAK "#" AT 

where the symbol # indicates that the search failed during the execution of an F 
command. 

The N Command 

The N command extends the search function beyond the memory buffer to include 
the source file. If the search is successful, it leaves the CP pointing to the first char- 
acter after the search string. The form of the N command is 

nNstring 

where n is the occurrence of the string to be found. If no number is entered, ED 
looks for the next occurrence of the string in the file. The case of the N command 
has the same effect on an N command as it does on an F command. Note that if you 
follow an N command with another ED command, you must terminate the string 
with a CTRL-Z. 

When an N command is executed, ED searches the memory buffer for the specified 
string, but if ED does not find the string, it does not issue an error message. Instead, 
ED automatically writes the searched data from the buffer into the new file. Then 
ED performs a OA command to fill the buffer with unsearched data from the source 
file. ED continues to search the buffer, write out data and append new data until it 
either finds the string or reaches the end of the source file. If ED reaches the end of 
the source file, ED issues the following message: 

BREAK "»" AT 

Because ED writes the searched data to the new file before looking for more data in 
the source file, ED usually writes the contents of the buffer to the new file before 
finding the end of the source file and issuing the error message. 

Note: you must use the H command to continue an edit session after the source file 
is exhausted and the memory buffer is emptied. 
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The J (Juxtapose) Command 

The J command inserts a string after the search string, then deletes any characters 
between the end of the inserted string to the beginning of the third delete-to string. 
This juxtaposes the string between the search and delete-to strings with the insert 
string. The form of the J command is 

njsearch string A Zinsert string A Zdelete-to string 

where n is the occurrence of the search string. If no number is specified, ED searches 
for the next occurrence of the search string in the memory buffer. In the following 
example, ED searches for the word "Dickinson" and inserts the phrase "told a friend" 
after it and then deletes everything up to the comma. 



Emily DicKinson said > 
"I find ecstasy in liuins - 
the mere sense of living 
is Joy enough." 

*JDickinson A Z told a f ri end % Z / 

*01t 
Emily DicKinson told a friend* 

# 



If you combine this command with other commands, you must terminate the 
delete-to string with a CTRL-Z or Esc. (This is shown in the following example). If 
an upper-case J command letter is specified, ED looks for upper-case search and 
delete-to strings and inserts an upper-case insert string. 

The J command is especially useful when revising comments in assembly language 
source code, as shown below. 



23G: SORT LXI 

23G: *Ji"ZADDRESS 

236: SORT LXI 

236: * 



Ht SW iADDRESS TOGGLE SWITCH 
SNITCH TOGGLE"Z"L A ZOLT 

Ht SW iADDRESS SWITCH TOGGLE 



In this example, ED searches for the first semicolon and inserts ADDRESS SWITCH 
TOGGLE after the mark and then deletes to the <cr><lf> sequence, represented by 
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CTRL-L. (In any search string, you can use CTRL-L to represent a <cr><lf> when 
your desired phrase extends across a line break. You can also use a CTRL-I in a 
search string to represent a tab.) 

Note: if long strings make your command longer than your screen line length, enter 
a CTRL-E to cause a physical carriage return at the screen. A CTRL-E returns the 
cursor to the left edge of the screen, but does not send the command line to ED. 
Remember that no ED command line containing strings can exceed 100 characters. 
When you finish your command, press the carriage-return key to send the command 
to ED. 

The M (Macro) Command 

An ED macro command, M, can increase the usefulness of a string of commands. 
The M command allows you to group ED commands together for repeated execu- 
tion. The form of the M command is 

nMcommand string 

where n is the number of times the command string is to be executed. A negative 
number is not a valid argument for an M command. If no number is specifed, the 
special character # is assumed, and ED executes the command string until it reaches 
the end of data in the buffer or the end of the source file, depending on the com- 
mands specified in the string. In the following example, ED executes the four com- 
mands repetitively until it reaches the end of the memory buffer: 

1 : *Mfl ivin4 A Z-GdiLivinf"ZQl t 
2: "I find ecstasy in Living - 
3: the mere sense of Liuins* 

BREAK "»" AT A Z 
3: * 

The terminator for an M command is a carriage return; therefore, an M command 
must be the last command on the line. Also, all character strings that appear in a 
macro must be terminated by CTRL-Z or Esc. If a character string ends the com- 
bined-command string, it must be terminated by CTRL-Z, then followed by a <cr> 
to end the M command. 
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The execution of a macro command always ends in a BREAK "#" message, even 
when you have limited the number of times the macro is to be performed and ED 
does not reach the end of the buffer or source file. Usually the command letter 
displayed in the message is one of the commands from the string and not M. 

To abort a macro command, strike a CTRL-C at the keyboard. 

6.6.3 Moving Text Blocks 

To move a group of lines from one area of your data to another, use an X 
command to write the text block into a temporary .LIB file, then a K command to 
remove these lines from their original location, and finally an R command to read 
the block into its new location. 

The X (Transfer) Command 

The X command takes the forms: 

nX 

nX filespec'Z 

where n is the number of lines from the CP towards the bottom of the buffer that 
are to be transferred to a temporary file; therefore, n must always be a positive 
number. If no filename is specified, X$$$$$$$ is assumed. If no filetype is specified, 
.LIB is assumed. If the X command is not the last command on the line, the com- 
mand must be terminated by a CTRL-Z or Esc. In the following example, just one 
line is transferred to the temporary file: 

1 : *X 

1 : *t 

1: *Emilv* DicKinson said* 

1 : * K t 

1: *"I find ecstasy in living - 

1: * 

If no library file is specified, ED looks for a file named X$$$$$$$.LIB. If the file 
does not exist, ED creates it. If a previous X command already created the library 
file, ED appends the specified lines to the end of the existing file. 

Use the special character as the n argument in an X command to delete any file 
from within ED. 
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The R (Read) Command 

The X command transfers the next n lines from the current line to a library file. 
The R command can retrieve the transferred lines. The R command takes the forms: 

R 
Rfilespec 

If no filename is specified, X$$$$$$$ is assumed. If no filetype is specified, .LIB is 
assumed. R inserts the library file in front of the CP; therefore, after the file is added 
to the memory buffer, the CP points to the same character it did before the read, 
although the character is on a new line number. If you combine an R command with 
other commands, you must separate the filename from subsequent command letters 
with a CTRL-Z as in the following example where ED types the entire file to verify 
the read. 



*4I 

*R"ZB#T 
"I find ecstasy in living" 
the mere sense of liuinS 
is Joy enough." 
Emily Dickinson said* 

# 



6.6.4 Saving or Abandoning Changes: ED Exit 

You can save or abandon editing changes with the following three commands: 

The H (Head of File) Command 

An H command saves the contents of the memory buffer without ending the ED 
session, but it returns to the "head" of the file. It saves the current changes and lets 
you reedit the file without exiting ED. The form of the H command is 

H 

followed by a carriage return. 
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To execute an H command, ED first finalizes the new file, transferring all lines 
remaining in the buffer and the source file to the new file. Then ED closes the new 
file, erases any .BAK file that has the same file specification as the original source file, 
and renames the original source file filename.BAK. ED then renames the new file, 
which has had the filetype .$$$, with the original file specification. Finally, ED opens 
the newly renamed file as the new source file for a new edit, and opens a new .$$$ 
file. When ED returns the * prompt, the CP is at the beginning of an empty memory 
buffer. 

If you want to send the edited material to a file other than the original file, use the 
following command: 

f\>ED filespec d i ffe rent f i 1 es pec 

If you then restart the edit with the H command, ED renames the file different- 
filename.$$$ to different filename.BAK and creates a new file of differentfilespec 
when you finish editing. 

The O (Original) Command 

An O command abandons changes made since the beginning of the edit and allows 
you to return to the original source file and begin reediting without ending the ED 
session. The form of the O command is 

O 

followed by a carriage return. When you enter an O command, ED confirms that 
you want to abandon your changes by asking: 

(Y/N)? 

You must respond with either a Y or an N; if you press any other key, ED repeats 
the question. When you enter Y, ED erases the temporary file and the contents of the 
memory buffer. When the * prompt returns, the character pointer is pointing to the 
beginning of an empty memory buffer, just as it is when you start ED. 
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The Q (Quit) Command 

A Q command abandons changes made since the beginning of the ED session and 
exits ED. The form of the Q command is 

Q 

followed by a carriage return. 

When you enter a Q command, ED verifies that you want to abandon the changes 
by asking: 

Q (Y/N)? 

You must respond with either a Y or an N; if you press any other key, ED repeats 
the question. When you enter Y, ED erases the temporary file, closes the source file, 
and returns control to CP/M-68K. 

Note: you can enter a CTRL-C to immediately return control to CP/M-68K. This 
does not give ED a chance to close the source or new files, but it prevents ED from 
deleting any temporary files. 

6 J ED Error Messages 

ED returns one of two types of error messages: an ED error message if ED cannot 
execute an edit command, or a CP/M-68K error message if ED cannot read or write 
to the specified file. 

The form of an ED error message is 

BREAK "x" AT c 

where x is one of the symbols defined in the following table and c is the command 
letter where the error occurred. 
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Table 6-4. ED Error Symbols 



Symbol 



Meaning 



Search failure. ED cannot find the string specified in an F, S, or N 
command. 

Unrecognized command letter c. ED does not recognize the indi- 
cated command letter, or an E, H, Q, or O command is not alone 
on its command line. 

No .LIB file. ED did not find the .LIB file specified in an R 
command. 

Buffer full. ED cannot put any more characters in the memory 
buffer, or string specified in an F, N, or S command is too long. 

Command aborted. A keystroke at the keyboard aborted com- 
mand execution. 

File error. Followed by either DISK FULL or DIRECTORY FULL. 



The following examples show how to recover from common editing error condi- 
tions. For example, 



BREAK 



AT A 



means that ED filled the memory buffer before completing the execution of an A 
command. When this occurs, the character pointer is at the end of the buffer and no 
editing is possible. Use the OW command to write out half the buffer or use an O or 
H command and reedit the file. 

BREAK "#" AT F 

means that ED reached the end of the memory buffer without matching the string in 
an F command. At this point, the character pointer is at the end of the buffer. Move 
the CP with a B or n: line number command to resume editing. 

BREAK "F" AT F 
DISK FULL 
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Use the OX command to erase an unnecessary file on the disk or a B#Xd:buffer.sav 
command to write the contents of the memory buffer onto another disk. 

BREAK "F" AT n 
DIRECTORY FULL 

Use the same commands described in the previous message to recover from this file 
error. 

The following table defines the disk file error messages ED returns when it cannot 
read or write a file. 



Table 6-5. ED Disk File Error Messages 



Message Meaning 



6D0S ERR ON d: RO 



Disk d: has Read-Only attribute. This occurs if a different disk 
has been inserted in the drive since the last cold or warm boot. 



** FILE IS READ ONLY ** 



The file specified in the command to invoke ED has the RO 
attribute. ED can read the file so that you can examine it, but 
ED cannot change a Read-Only file. 



End of Section 6 
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Appendix A 
Error Messages 



Error messages come from several different sources. Each utility supplied with 
CP/M-68K has its own set of error messages. These messages are displayed when 
there are errors in the utility command lines. CP/M-68K also displays error messages 
when there are errors in calls to its built-in system modules: the Basic Disk Operating 
System (BDOS), the Basic I/O System (BIOS), and the Console Command Processor 
(CCP). The BDOS provides functions that access the file system, the BIOS provides 
functions that interface the peripheral device drivers for I/O processing, and the CCP 
provides the user interface that parses the user command line. 

The utility error messages and the CP/M-68K system error messages are listed in 
Table A-l in alphabetic order with explanations and suggested user responses. The 
utility or system module that returns the error message is indicated in the explana- 
tion. If you are running an application program, you may see messages other than 
those listed here. Check the application program's documentation for explanations 
of those messages. 
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Table A-l. CP/M-68K Error Messages 



Message Meaning 



BAD DIRECTORY ON D: 

SPACE ALLOCATION CONFLICT 



STAT error. This message is followed by a list of one or more 
filenames. The files listed have been doubly allocated and contain 
data blocks that are already allocated to another file on the disk. 
The error can be caused by either a hardware or software failure. 

If you have maintained a backup disk with copies of your files, 
ERAse the affected files and reboot CP/M-68K. Rebooting the 
system cleans up the directory by reconstructing the directory 
allocation vectors. If you do not reboot the system the error recurs. 
To replace the files you erased, COPY or PIP the files from your 
backup disk. 

If you do not have a back-up disk, you must recreate the doubly 
allocated files. If you can tell by careful checking which portions 
of the files are duplicated or deleted, you can reCOPY or PIP the 
files from the doubly allocated disk onto a new disk. Use ED to 
recreate the deleted portions and to delete the parts that were 
added to the wrong files. To clean up the doubly allocated disk 
so that it can be used again, ERAse it completely (ERA *.*) and 
reboot CP/M-68K. 

The problem that caused this error might or might not recur. If 
you were running an undebugged program at the time the error 
occurred, check the program carefully for an error that may have 
caused the space allocation error. If you were running a program 
that has been debugged and has caused no problem before, check 
your hardware. The error might have been caused by a damaged 
drive or loose connection. If the problem persists, contact your 
technical support personnel or the place you purchased your sys- 
tem for further assistance. 
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Table A-l. (continued) 



Message Meaning 



bad relocation information bits 



CCP error. The message indicates that the file specified in the 
command line is not a valid executable command file, or that the 
file has been corrupted. 

Ensure that the file is a command file. Section 3 of this manual 
describes the format of a command file. If the file has been cor- 
rupted, reassemble or recompile the source file, and relink it before 
you reenter the command line. 



BIOS ERROR -- DISK X NOT SUPPORTED 



BIOS error. The disk drive indicated by the variable X is not 
supported by the BIOS. The BDOS supports a maximum of 16 
drives, lettered A through P. Check the documentation provided 
by the manufacturer for your system configuration to find out 
which of the BDOS drives your BIOS implements. Specify the 
correct drive code and reenter the command line. 



BIOS ERROR -- Inualid Disk Status 



BIOS error. The disk controller returned unexpected or incompre- 
hensible information to the BIOS. Retry the operation. If the error 
persists, check the hardware. If the error does not come from the 
hardware, it is caused by an error in the internal logic of the 
BIOS. Contact the place you purchased your system for assis- 
tance. You should provide the following information: 

■ Indicate which version of the operating system you are using. 

■ Describe your system's hardware configuration. 

o Provide sufficient information to reproduce the error. Indicate 
which program was running at the time the error occurred. If 
possible, you should also provide a disk with a copy of the 
program. 
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Table A-l. (continued) 



Message Meaning 



BREAK "x" AT c 



ED error. Where "x" is one of the symbols described below and 
c is the command letter being executed when the error occurred. 

« Search failure. ED cannot find the string specified in a F, 

S, or N command. 

? Unrecognized command letter c. ED does not recognize 

the indicated command letter, or an E, H, Q, or O com- 
mand is not alone on its command line. 

The file specified in a R command could not be found. 

> Buffer full. ED cannot put any more characters in the 

memory buffer, or the string specified in an F, N, or S 
command is too long. 

E Command aborted. A keystroke at the console aborted 

command execution. 

F Disk or directory full. This error is followed by either the 

disk or directory full message. Refer to the recovery pro- 
cedures listed under these messages. 



CANNOT EDIT WILDCARD FILENAME 



ED error. A wildcard (*) filename was requested when invoking 
ED. ED does not support wildcard filenames as sources. Request 
a specific filename and reenter the ED command line. 
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Table A-l. (continued) 



Message Meaning 



CP/MDisK change error on driue x 



Disk error. The disk in the drive indicated by the variable x is 
not the same disk the system logged in previously. When the disk 
was replaced, you did not enter a CTRL-C to log in the current 
disk. Therefore, when you attempted to write to, erase, or rename 
a file on the current disk, the BDOS set the drive status to Read- 
only and warm booted the system. The current disk in the drive 
was not overwritten. The drive status was returned to Read-Write 
when the system was warm booted. 

Each time a disk is changed, you must type a CTRL-C to log in 
the new disk. 



CP/MDisK file error: filename is read-only. 

Do you want to: Change it to read/write (C)» or Abort (A)? 

Disk error. You attempted to write to, erase, or rename a file 
whose status is Read-Only. Specify one of the options enclosed in 
parentheses. If you specify the C option, the BDOS changes the 
status of the file to Read- Write and continues the operation. The 
Read-Only protection previously assigned to the file is lost. If you 
specify the A option or a CTRL-C, the program terminates and 
CPM-68K returns the system prompt. 
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Table A-l. (continued) 



Message 



Meaning 



CP/MDisk read error on drive x 

Do you want to: Abort (A) t Retry (R) t or Continue with bad 
data <C>? 

Disk error. This message indicates a hardware error. Specify one 
of the options enclosed in parentheses. Each option is described 
below. 

A or Terminates the operation and CP/M-68K returns the 

CTRL-C system prompt. 

R Retries the operation. If the retry fails, the system 

reprompts with the option message. 

C Ignores the error and continues program execution. 

Be careful if you use this option. Program execution 
should not be continued for some types of pro- 
grams. For example, if you are updating a data base 
and receive this error, but continue program execu- 
tion, you can corrupt the index fields and the entire 
data base. For other programs, continuing program 
execution is recommended. For example, when you 
transfer a long text file and receive an error because 
one sector is bad, you can continue transferring the 
file. After the file is transferred, review the file, and 
add the data that was not transferred due to the 
bad sector. 
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Table A-l. (continued) 



Message 



Meaning 



CP/M Disk write error on drive x 

Do you want to: Abort (A) » Retry (R) t or Continue with bad 

data (O? 

Disk error. This message indicates a hardware error. Specify one 
of the options enclosed in parentheses. Each option is described 
below. 

A or Terminates the operation and CP/M-68K returns the 

CTRL-C system prompt. 

R Retries the operation. If the retry fails, the system 

reprompts with the option message. 

C Ignores the error and continues program execution. 

Be careful if you use this option. Program execution 
should not be continued for some types of pro- 
grams. For example, if you are updating a data base 
and receive this error but continue program execu- 
tion, you can corrupt the index fields and the entire 
data base. For other programs, continuing program 
execution is recommended. For example, when you 
transfer a long text file and receive an error because 
one sector is bad, you can continue transferring the 
file. After the file is transferred, review the file, and 
add the data that was not transferred due to the 
bad sector. 



CP/MDisK select error on drive x 
Do you want to: Abort (A) t Retry (R) 



Disk error. There is no disk in the drive or the disk is not inserted 
correctly. Ensure that the disk is securely inserted in the drive. If 
you enter the R option, the system retries the operation. If 
you enter the A option or CTRL-C the program terminates and 
CP/M-68K returns the system prompt. 



So) DIGITAL RESEARCH™ 



A-7 



A Error Messages CP/M-68K User's Guide 

Table A-l. (continued) 



Message Meaning 



CP/MDisK select error on drive x 



Disk error. The disk selected in the command line is outside the 
range A through P. CP/M-68K can support up to 16 drives, let- 
tered A through P. Check the documentation provided by the 
manufacturer to find out which drives your particular system con- 
figuration supports. Specify the correct drive code and reenter the 
command line. 



DIRECTORY FULL 



ED error. There is not enough directory space for the file being 
written. 

You can use the OXfilespec command to erase any unnecessary 
files on the disk without leaving the editor. Alternatively, you can 
save the contents of the memory buffer on another disk with the 
command, B#Xfilespec, where filespec is a file on a different drive. 
You can then quit the edit. If you reedit the file, the output should 
be placed on a different drive with the command, ED filespec d:, 
where d: is a valid drive name other than the drive containing the 
source file. 

You can read the file saved with the Rfilespec command. Caution, 
part of the file may not be in the memory buffer when you save 
it (if you have not appended the whole file or if you have issued 
any W commands). 



DISK FULL 



ED error. There is not enough disk space for the output file. This 
error can occur on the W, E, H, or X commands. If it occurs 
with the X command you can repeat the command, prefixing the 
filename with a different drive. Otherwise you can try the recov- 
ery methods described above under the Directory Full error. 
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Table A-l. (continued) 



Message Meaning 



Disk select error on Destination 
DisK select error on Source 
ERROR 



Disk, COPY, INIT error. The disk selected in the command line 
is not supported by CP/M-68K. CP/M-68K can support up to 16 
drives, lettered A through P. Check the documentation provided 
by the manufacturer to find out which drives your particular sys- 
tem configuration supports. Specify the correct drive code and 
reenter the command line. 



ERROR: 6AD PARAMETER 



PIP error. The command contains an illegal parameter. Refer to 
the section in this User's Guide on the PIP command for an expla- 
nation and listing of the PIP command parameters. Reenter the 
command with a valid parameter. 



ERROR: CLOSE FILE - -C f ilespec} 



PIP error. The output file specified in the previous PIP command 
cannot be closed. This message indicates a fatal error in the inter- 
nal logic of PIP. Contact the place you purchased your system for 
assistance. You should provide the following information. 

■ Indicate which version of the operating system you are using. 

■ Describe your system's hardware configuration. 

■ Provide sufficient information to reproduce the error. Indicate 
which program was running at the time the error occurred. If 
possible, you should also provide a disk with a copy of the 
program. 
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Table A-l. (continued) 



Message Meaning 



ERROR: DESTINATION IS R/0 » DELETE (Y/N>? 

PIP error. The destination file specified in a PIP command already 
exists and it is Read-Only. If you type Y, the existing file is deleted 
and replaced with the file specified in the PIP command. If you 
do not want to delete the existing file, type N and reenter the PIP 
command with a different destination file specification: either 
specify a new filename, or direct the destination file to a different 
disk. This message can be avoided by using the W option. Refer 
to the section of this User's Guide on the PIP command for a 
discussion and list of the PIP options. 



ERROR: DISK READ - {filespec} 



PIP error. PIP cannot read the input file indicated by the variable, 
filespec. This message indicates a bad disk. Ensure that the disk is 
in place and retry the operation. If the error persists, the disk is 
bad and must be replaced. COPY or PIP as much of the bad disk 
as possible, or use your back-up disk, if you maintained one, to 
replace the lost files. 



ERROR: DISK WRITE - -Cfilespec} 



PIP error. The disk to which PIP is writing is full. The file indi- 
cated by the variable, filespec, was not copied. Reenter the PIP 
command line and redirect the output to another disk, if possible. 
If you do not have another disk available, you must erase unnec- 
essary files, if any, or replace the disk before you reenter the PIP 
command line. 



ERROR: FILE NOT FOUND - -Cfilespec} 



PIP error. The input file indicated by the variable, filespec, does 
not exist, or the drive code or user number is incorrect. Ensure 
that you are typing the correct filename and drive code, and that 
you are in the correct user number or have specified the correct 
user number in the option brackets before you reenter the PIP 
command line. 
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Table A-l. (continued) 



Message Meaning 



ERROR: HEX RECORD CHECKSUM - <f ilespec} 

PIP error. A hex record checksum error was encountered during 
the transfer of a hex file. This message indicates a corrupted or 
truncated hex file. ReCOPY or PIP the hex file from your back- 
up disks, if possible. If you do not have a back-up, you must 
ERAse the bad file and recreate it. 



ERROR: INVALID DESTINATION 



PIP error. The destination specified in your PIP command is ille- 
gal. You have specified an input device as a destination, or used 
a wildcard file specification. Respecify the PIP command with an 
output device or a specific file as the destination. Refer to the 
section of this user's guide on the PIP command for a discussion 
of the valid PIP destinations. 



ERROR: INVALID FORMAT 



PIP error. The format of your PIP command is illegal. Refer to 
the section of this user's guide on the PIP command for the cor- 
rect syntax. 



ERROR: INVALID HEX DIGIT - i f i 1 espec > 

PIP error. An invalid hex digit has been encountered while read- 
ing a hex file. This message indicates a truncated or corrupted 
hex file. ReCOPY or PIP the file from your backup disk. If you 
do not have a backup, you must ERAse the bad file and recreate 
it. 



ERROR: INVALID SEPARATOR 



PIP error. You have placed an invalid character for a separator 
between two input filenames. Reenter the PIP command line using 
a comma as the separator between the input filenames. 
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Table A-l. (continued) 



Message Meaning 



ERROR: INVALID SOURCE 



PIP error. The source specified in your PIP command is illegal. 
You have specified an output device as a source or used a wild- 
card filename. Reenter the PIP command line with an input device 
or a specific filename as the source. Refer to the section of this 
User's Guide on PIP for a discussion of the legal sources for a PIP 
command. 



ERROR: INVALID USER NUMBER 



PIP error. You have specified a user number greater than 15. User 
numbers are in the range to 15. Reenter the PIP command line 
using a valid user number. 



ERROR: NO DIRECTORY SPACE - if ilespec> 

PIP error. The disk to which PIP is writing has no directory space 
available. 

ERAse unnecessary files, if any, or replace the disk before you 
reenter the PIP command line. 



ERROR: QUIT NOT FOUND 



PIP error. The string argument to a Q parameter was not found 
in your input file. Ensure that you typed the correct string and 
retry the operation. This error can also occur when entering the 
Q option from the CP/M-68K command line. CP/M-68K trans- 
lates everything in the command line into upper-case. To avoid 
this problem, enter the Q option from inside PIP. Enter PIP, and 
wait for the * prompt before entering the file specifications and 
Q option. 
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Table A-l. (continued) 



Message Meaning 



ERROR: START NOT FOUND 



PIP error. The string argument to an S parameter could not be 
found in the source file. Ensure that you are typing the correct 
string and retry the operation. This error can also occur when 
entering the S option from the CP/M-68K command line. 
CP/M-68K translates everything in the command line into upper- 
case. To avoid this problem, enter the S option from inside PIP. 
Enter PIP, and wait for the * prompt before entering the file spec- 
ifications and S option. 



ERROR: UNEXPECTED END OF HEX FILE - -Cf ilespec> 

PIP error. The last hex record was not as long as the character 
count indicated. The hex file is truncated. ReCOPY or PIP the 
truncated file from your back-up disk. If you do not have a back- 
up, you must ERAse the bad file and recreate it. 



ERROR: USER ABORTED 



PIP error. You aborted a PIP operation by entering a CTRL-C or 
by pressing a key. If you did not intend to abort the operation, 
you must reenter the PIP command line. 



ERROR: VERIFY - -Cfilespec} 



PIP error. When copying with the V option, PIP found a differ- 
ence when rereading the data just written and comparing it to the 
data in its memory buffer. This indicates a bad disk or a hard- 
ware error. Retry the operation. If the error persists, insert a new 
disk and reenter the PIP command line. If the error still persists, 
check the hardware. 
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Table A-l. (continued) 



Message Meaning 



Extraneous argument ignored argument? 

COPY error. The command line contains too many arguments. 
The extraneous arguments are indicated by the variable, argu- 
ments. The command was carried out up to, but not including, 
the extraneous arguments. Refer to the section in this user's guide 
on COPY for the correct syntax of the COPY command line. 
Reenter the command line with the correct syntax for the remain- 
ing arguments. 



File already exists 



REN error. The name specified in the command line as the new 
filename already exists. Use the ERA command to delete the exist- 
ing file if you wish to replace it with the new file. If not, select 
another filename and reenter the REN command line. 



FILE IS READ/ONLY 



ED error. A Read-Only file cannot be edited with the ED com- 
mand: ED filespec. The command, ED inputfilespec outputfilespec, 
should be used instead. 



FILE NOT FOUND 

FILE NOT FOUND - {filespec} 



ED, STAT error. ED or STAT could not find the file indicated by 
the variable, filespec. Check the filename, drive code and user 
number before you reenter the command line. 



FILENAME REQUIRED 



ED error. The ED command was typed without a filename. Reen- 
ter the ED command followed by the name of the file you wish 
to edit or create. 
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Table A-l. (continued) 



Message Meaning 



Formatting Error 



FORMAT error. This message indicates either a bad disk or a 
hardware error. Retry the operation. If the error recurs, replace 
the disk with a new disk. If the error persists, look for a hardware 
error. Contact your technical support personnel or the place you 
purchased your system for assistance. 



insufficient memory or bad file header 

CCP error. This error could result from one of three causes: 

n The file is not a valid executable command file. 

■ The program is too large for the available memory. 

■ The program is linked to an absolute location in memory that 
cannot be used. 

Ensure that you are requesting the correct file. This error can 
occur when you enter the filename before you enter the command 
for a utility. Check the appropriate section of this user's guide or 
the CP/M-68K Operating System Programmer's Guide for the 
correct command syntax before you reenter the command line. If 
you are trying to run a program when this error occurs, the pro- 
gram file may have been corrupted. Reassemble or recompile the 
source file and relink it before you reenter the command line. 

Add more memory boards to the system configuration, or rewrite 
the program to use less memory. 

The program must be made relocatable, or linked to a usable 
memory location. The BDOS Get/Set TPA Limits Function (63) 
returns the high and low boundaries of the memory space that is 
available for loading programs. See the CP/M-68K Operating 
System Programmer's Guide for more information on Function 
63. 
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Table A-l. (continued) 



Message Meaning 



INVALID ASSIGNMENT 

USE: STAT D : FILENAME.TYP [SIZE] CRO] CRW] CSYS] OR CDIR] 

STAT error. An invalid file assignment was attempted. The error 
message is followed by the correct syntax and a list of the valid 
file assignments. Refer to the section of this user's guide on the 
STAT command for a discussion of file status assignments. Specify 
a valid file assignment and reenter the STAT command line. 



INVALID FILENAME 



ED error. The filename specified is too long, or a delimiter was 
used as the first character. Filenames cannot be longer than eight 
characters. Refer to the section of this user's guide on naming 
files for a list and description of the delimiters that cannot be 
used as the first character in a filename. Correct the filename and 
reenter the ED command line. 



Invalid or Missins driue code 



FORMAT error. The FORMAT command line is either missing a 
drive code specification, or the drive specified is not supported by 
the BDOS. CP/M-68K can support up to 16 drives, lettered A 
through P. Check the documentation provided by the manufac- 
turer to find out which drives your particular system configura- 
tion supports. Specify the correct drive code and reenter the com- 
mand line. 



No file 



CCP, COPY, ERA, REN error. The filename specified in the com- 
mand line does not exist. Ensure that you use the correct filename 
and reenter the command line. 
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Table A-l. (continued) 



Message Meaning 



NO MEMORY 



ED error. There is not enough space in available memory to cre- 
ate the buffer that ED requires to edit a file. Contact your tech- 
nical support personnel or place of purchase for assistance. This 
problem can occur when ED is absolutely linked too high in the 
TPA to allow for the buffer. ED needs 4K of memory at a loca- 
tion immediately higher in memory than itself for a buffer. Relo- 
cate ED to a lower location. If ED is not linked too high, recon- 
figure the TPA of your system, if possible, by eliminating some 
system extensions. If it is not possible to reconfigure the TPA, 
additional memory boards must be added to the system configu- 
ration to run ED. 



No wildcard filenames 



CCP, REN error. The command specified in the command line 
does not accept wildcards in file specifications. Response: Retype 
the command line using a specific filename. 



OUTPUT FILE EXISTS t ERASE IT 



ED error. This error occurs when placing the destination file on a 
different disk than the source. The destination filename already 
exists on the receiving disk. The existing file should be erased or 
another disk selected to receive the output file. 



d DIGITAL RESEARCH™ 

A-17 



A Error Messages CP/M-68K User's Guide 

Table A-l. (continued) 



Message Meaning 



Program Load Error 



CCP error. This message indicates an undefined failure of the 
BDOS. Reboot the system and try again. If the error persists, then 
it is caused by an error in the internal logic of the BDOS. Contact 
the place you purchased your system for assistance. You should 
provide the following information: 

■ Indicate which version of the operating system you are using. 

■ Describe your system's hardware configuration. 

■ Provide sufficient information to reproduce the error. Indicate 
which program was running at the time the error occurred. If 
possible, you should also provide a disk with a copy of the 
program. 



READ error > Track: t Sectors s 

COPY error. This message indicates a bad disk. The variable t is 
replaced with the number of the track where the error occurred. 
The variable s is replaced with the number of the bad sector. 
Retry the operation. If the error persists, use a new disk and 
COPY or PIP as many files as possible from the damaged disk. If 
you cannot COPY or PIP a file, you must replace the file from 
your backup disk. If you have not maintained a backup disk, you 
must recreate the lost file. Discard the damaged disk. 



read error on program load 



CCP error. This message indicates a premature end-of-file. The 
file is smaller than the header information indicates. Either the 
file header has been corrupted or the file was only partially writ- 
ten. If the program is one you have written, you must reassemble 
or recompile the source file, and relink it before you reenter the 
command line. If this message occurs at any other time, and you 
have a backup copy of the program you were running, erase the 
program file and replace it from your backup files. If the error 
reoccurs, contact your technical support personnel or the place 
you purchased your system for assistance in locating the cause of 
the error. 
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Table A-l. (continued) 



Message Meaning 



READ ONLY DRIVE STATUS NOT ALLOWED 



STAT error. Read-Only drive status is not supported by CP/M-68K. 
Assign each file on the disk Read-Only status individually. 



Select Error 

FORMAT, INIT error. This message indicates one of three errors: 

■ The drive specified is not supported by your system. 

■ The disk on the drive selected is not in place. 

■ A hardware error. 

CP/M-68K supports a maximum of 16 drives, lettered A through 
P. Check the documentation provided by the manufacturer to find 
out which of these drives your particular system configuration 
supports. Reenter the command line with a valid drive code 
specification. 

Check the disk. Ensure that it is securely in place and that the 
drive door is closed. 

If the disk is in place and you have selected a valid drive code, 
look for a hardware error. The error might have been caused by 
a loose connection or damaged drive. Contact your technical sup- 
port personnel or the place you purchased your system for further 
assistance. 



Source and Destination must be different 

COPY error. The source and destination drives specified are the 
same. Reenter the COPY command line with a different drive for 
the source than for the destination. 



SUB file not found 



SUBMIT error. The file requested either does not exist, or does 
not have a filetype of SUB. Ensure that you are requesting the 
correct file. Refer to the section on the SUBMIT command in this 
user's guide for information on creating and using submit files. 
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Table A-l. (continued) 



Message Meaning 



Syntax: REN newf i 1 e = o 1 df i 1 e 



REN error. The syntax of the REN command line is incorrect. 
The correct syntax is given in the error message. Enter the REN 
command followed by a space, then the new filename, followed 
immediately by an equals sign and the name of the file you want 
to rename. 



Too many arguments: a r 3 u m e n t ? 



DIR, ERA, TYPE, USER error. The command line contains too 
many arguments. The extraneous arguments are indicated by the 
variable, argument. Refer to the appropriate section in this user's 
guide for the correct syntax for the command. Specify only as 
many arguments as the command syntax allows and reenter the 
command line. Use a second command line for the remaining 
arguments if appropriate. The command might be repeated on 
one command line when separated by an exclamation point; for 
example, DIR a: !DIR b:. 



TOO MANY FILES 

TOO MANY ENTRIES IN INDEX TABLE 



STAT error. There is not enough memory for STAT to sort the 
files specified or more than 512 files were specified. Move some 
files to another user number, or otherwise break the group of files 
into smaller groups before you reenter the STAT command line. 
For example, use a wildcard (*.typ) to run STAT on only those 
files with a certain filetype. 



Un defined option 



COPY error. The option specified in the COPY command line is 
unsupported. The only COPY options supported by CP/M-68K 
are a, for automatic, and v, for verify. Correct and reenter the 
COPY command line. 
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Table A-l. (continued) 



Message Meaning 



User* ranae is CO- 15] 



CCP error. The user number specified in the command line is not 
supported by the BIOS. The valid range is enclosed in the square 
brackets in the error message. Specify a user number between 
and 15 (decimal) when you reenter the command line. 



Write Error 



FORMAT, INIT error. This message indicates either a bad disk 
or a hardware error. Retry the operation. If the error recurs, 
replace the disk with a new disk. If the error persists, look for a 
hardware error. The error may have been caused by a loose con- 
nection or damaged drive. Contact your technical support person- 
nel or the place you purchased your system for further assistance. 



WRITE error > Track: t Sector: 5 

COPY error. This message indicates a bad disk. The variable t is 
replaced with the number of the track where the error occurred. 
The variable s is replaced with the number of the bad sector. 
Retry the operation. If the error persists, use a new disk and copy 
as many files as possible from the damaged disk. If you cannot 
copy a file, you must replace the file from your backup disk. If 
you have not maintained a backup disk, you must recreate the 
lost file. Discard the damaged disk. 



End of Appendix A 
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Appendix B 
ASCII and Hexadecimal Conversions 



ASCII stands for American Standard Code for Information Interchange. The code 
contains 96 printing and 32 nonprinting characters used to store data on a disk. 
Table B-l defines ASCII symbols, then Table B-2 lists the ASCII and hexadecimal 
conversions. The table includes binary, decimal, hexadecimal, and ASCII conversions. 



Table B-l. ASCII Symbols 



Symbol 


Meaning 


Symbol 


Meaning 


ACK 


acknowledge 


FS 


file separator 


BEL 


bell 


GS 


group separator 


BS 


backspace 


HT 


horizontal tabulation 


CAN 


cancel 


LF 


line-feed 


CR 


carriage return 


NAK 


negative acknowledge 


DC 


device control 


NUL 


null 


DEL 


delete 


RS 


record separator 


DLE 


data link escape 


SI 


shift in 


EM 


end of medium 


SO 


shift out 


ENQ 


enquiry 


SOH 


start of heading 


EOT 


end of transmission 


SP 


space 


ESC 


escape 


STX 


start of text 


ETB 


end of transmission 


SUB 


substitute 


ETX 


end of text 


SYN 


synchronous idle 


FF 


form-feed 


US 


unit separator 






VT 


vertical tabulation 
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Table B-2. ASCII Conversion Table 




Binary 


Decimal 


Hexadecimal 


ASCII 


0000000 








NUL 




0000001 


1 


1 


SOH 


(CTRL-A) 


0000010 


2 


2 


STX 


(CTRL-B) 


0000011 


3 


3 


ETX 


[CTRL-Q 


0000100 


4 


4 


EOT 


(CTRL-D) 


0000101 


5 


5 


ENQ 


(CTRL-E) 


0000110 


6 


6 


ACK 


(CTRL-F) 


0000111 


7 


7 


BEL 


(CTRL-G) 


0001000 


8 


8 


BS 


(CTRL-H) 


0001001 


9 


9 


HT 


(CTRL-I) 


0001010 


10 


A 


LF 


(CTRL-J) 


0001011 


11 


B 


VT 


(CTRL-K) 


0001100 


12 


C 


FF 


(CTRL-L) 


0001101 


13 


D 


CR 


(CTRL-M) 


0001110 


14 


E 


SO 


(CTRL-N) 


0001111 


15 


F 


SI 


(CTRL-O) 


0010000 


16 


10 


DLE 


(CTRL-P) 


0010001 


17 


11 


DC1 


(CTRL-Q) 


0010010 


18 


12 


DC2 


(CTRL-R) 


0010011 


19 


13 


DC3 


(CTRL-S) 


0010100 


20 


14 


DC4 


(CTRL-T) 


0010101 


21 


15 


NAK 


(CTRL-U) 


0010110 


22 


16 


SYN 


(CTRL-V) 


0010111 


23 


17 


ETB 


(CTRL-W) 


0011000 


24 


18 


CAN 


(CTRL-X) 


0011001 


15 


19 


EM 


(CTRL-Y) 


0011010 


26 


1A 


SUB 


(CTRL-Z) 


0011011 


27 


IB 


ESC 


(CTRL-[ ) 


0011100 


28 


1C 


FS 


(CTRLA ) 


0011101 


29 


ID 


GS 


(CTRL-] ) 


0011110 


30 


IE 


RS 


(CTRL-' ) 


0011111 


31 


IF 


US 


(CTRL- ) 


0100000 


32 


20 


(SPACE) 




0100001 


33 


21 


! 




0100010 


34 


22 


ii 




0100011 


35 


23 


# 




0100100 


36 


24 


$ 




0100101 


37 


25 


% 
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Table B-2. (continued) 



Binary 


Decimal 


Hexadecimal 


ASCII 


0100110 


38 


26 


& 


0100111 


39 


27 


> 


0101000 


40 


28 


( 


0101001 


41 


29 


) 


0101010 


42 


2A 


* 


0101011 


43 


2B 


+ 


0101100 


44 


2C 


» 


0101101 


45 


2D 


- 


0101110 


46 


2E 


. 


0101111 


47 


2F 


/ 


0110000 


48 


30 





0110001 


49 


31 


1 


0110010 


50 


32 


2 


0110011 


51 


33 


3 


0110100 


52 


34 


4 


0110101 


53 


35 


5 


0110110 


54 


36 


6 


0110111 


55 


37 


7 


0111000 


56 


38 


8 


0111001 


57 


39 


9 


0111010 


58 


3A 


: 


0111011 


59 


3B 


> 


0111100 


60 


3C 


< 


0111101 


61 


3D 


= 


0111110 


62 


3E 


> 


0111111 


63 


3F 


? 


1000000 


64 


40 


@ 


1000001 


65 


41 


A 


1000010 


66 


42 


B 


1000011 


67 


43 


C 


1000100 


68 


44 


D 


1000101 


69 


45 


E 


1000110 


70 


46 


F 


1000111 


71 


47 


G 


1001000 


72 


48 


H 


1001001 


73 


49 


I 


1001010 


74 


4A 


J 


1001011 


75 


4B 


K 
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Table B-2. (continued) 



Binary 


Decimal 


Hexadecimal 


ASCII 


1001100 


16 


4C 


L 


1001101 


77 


4D 


M 


1001110 


78 


4E 


N 


1001111 


79 


4F 


O 


1010000 


80 


50 


P 


1010001 


81 


51 


Q 


1010010 


82 


52 


R 


1010011 


83 


53 


S 


1010100 


84 


54 


T 


1010101 


85 


55 


U 


1010110 


86 


56 


V 


1010111 


87 


57 


W 


1011000 


88 


58 


X 


1011001 


89 


59 


Y 


1011010 


90 


5A 


Z 


1011011 


91 


5B 


[ 


1011100 


92 


5C 


\ 


1011101 


93 


5D 


] 


1011110 


94 


5E 


* 


1011111 


95 


5F 


< 


1100000 


96 


60 


5 


1100001 


97 


61 


a 


1100010 


98 


62 


b 


1100011 


99 


63 


c 


1100100 


100 


64 


d 


1100101 


101 


65 


e 


1100110 


102 


66 


f 


1100111 


103 


61 


g 


1101000 


104 


68 


h 


1101001 


105 


69 


i 


1101010 


106 


6k 


J 


1101011 


107 


6B 


k 


1101100 


108 


6C 


1 


1101101 


109 


6D 


m 


1101110 


110 


6E 


n 


1101111 


111 


6F 


o 


1110000 


112 


70 


P 
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Table B-2. (continued) 



Binary 


Decimal 


Hexadecimal 


ASCII 


1110001 


113 


71 


q 


1110010 


114 


72 


r 


1110011 


115 


73 


s 


1110100 


116 


74 


t 


1110101 


117 


75 


u 


1110110 


118 


76 


V 


1110111 


119 


77 


w 


1111000 


120 


78 


X 


1111001 


121 


79 


y 


1111010 


122 


7A 


z 


1111011 


123 


7B 


{ 


1111100 


124 


7C 


1 


1111101 


125 


7D 


} 


1111110 


126 


7E 


- 


1111111 


127 


7F 


DEL 



End of Appendix B 
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Appendix C 
Filetypes 



CP/M-68K identifies every file by a unique file specification, which consists of a 
drive specification, a filename, a filetype, and an optional password. The filetype is 
an optional three-character ending separated from the filename by a period. The 
filetype generally indicates a special kind of file. The following table lists common 
filetypes and their meanings. 



Table C-l. Common Filetypes 



Type 


Meaning 


S 


Assembly language source file; the CP/M-68K Assembler assembles 
or translates a type .S file into machine language. 


BAK 


Back-up file created by text editor; the editor renames the source file 
with this filetype to indicate that the original file has been processed. 
The original file stays on disk as the back-up file, so you can refer to 
it. 


C 


Program source file written in the C language. 


6SK 


68000 executable file. 


H 


Header files for C language programs. 


HEX 


Program file in hexadecimal format. 





Compiled or assembled object files. 
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Table C-l. (continued) 



Type 



Meaning 



PRN Printable file display able on console or printer. 

REL Relocatable file produced by LO68 when the — R option is used. 

REL files may be converted to .68K files by using the RELOC utility. 
RELOC is explained in the CP/M-68K Operating System Program- 
mer's Guide. 

SUB Filetype required for submit file containing one or more CP/M-68K 

commands. The SUBMIT program executes commands in files of 
type SUB, providing a batch execution mode for CP/M-68K. 

SYS System file for CP/M-68K. 

$$$ Temporary file which is inaccessible by user. 



End of Appendix C 
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CP/M-68K Control Character Summary 



Table D-l. CP/M-68K Control Characters 



Keystroke 



Action 



CTRL-C Terminates executing transient utility program. Also terminates 

DIR, DIRS, SUBMIT, and TYPE Built-in programs in progress. 
When entered as first character in a command line or during the 
execution of the above-mentioned programs, causes a warm start 
and the redisplay of the system prompt. (Please see Section 4.4 
for a discussion of warm start.) 

CTRL-E Forces a physical carriage return but does not send the com- 

mand line to CP/M-68K. Moves the cursor to the beginning of 
the following line without erasing your previous input. 

CTRL-H Deletes a character and moves the cursor left one character 

position. 

CTRL-I Moves the cursor to the next tab stop. Tab stops are automati- 

cally set at each eighth column. Has the same effect as the TAB 
key. 

CTRL-J Moves the cursor to the left of the current line and sends the 

command line to CP/M-68K. Has the same effect as a carriage 
return keystroke. 

CTRL-M Moves the cursor to the left of the current line and sends the 

command line to CP/M-68K. Has the same effect as a carriage 
return keystroke. 
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Table D-l. (continued) 



Keystroke 



Action 



CTRL-P Echoes all console activity to the printer. You can use CTRL-P 

after you halt scrolling with CTRL-S. A second CTRL-P ends 
printer echo. If your system is not connected to a printer, a 
CTRL-P can cause your system to hang, requiring a cold start, 
that is, a complete resetting of your hardware and software. 
(Please see Section 1.1 for a description of a cold start.) 

CTRL-Q Restarts screen scrolling after a CTRL-S. 

CTRL-R Types a # at the current cursor location, moves the cursor to 

the next line, and retypes any partial command you have typed 
so far. 

CTRL-S Stops screen scrolling. If a display scrolls by too fast for you to 

read it, type CTRL-S. CTRL-Q restarts screen scrolling. 

CTRL-U Discards all the characters in the command line that you typed 

so far, types a # at the current cursor position, and moves the 
cursor to the next command line. 

CTRL-X Discards all the characters in the command line that you typed 

so far and moves the cursor back to the beginning of the current 
line. 



End of Appendix D 
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User's Glossary 



ambiguous filename: Filename that contains either of the CP/M-68K wildcard char- 
acters, ? or *, in the primary filename or the filetype or both. When you replace 
characters in a filename with these wildcard characters, you create an ambiguous 
filename and can easily reference more than one CP/M-68K file in a single command 
line. See Section 2 of this manual. 

applications program: Program that needs an operating system to provide an envi- 
ronment in which to execute. Typical applications programs are business accounting 
packages, word processing (editing) programs and mailing list programs. 

argument: Symbol, usually a letter, indicating a place into which you can substitute 
a number, letter or name to give an appropriate meaning to the formula in question. 

ASCII: The American Standard Code for Information Interchange is a standard 
code for representation of numbers, letters, and symbols. An ASCII text file is a file 
that can be intelligibly displayed on the video screen or printed on paper. See Appen- 
dix A. 

attribute: File characteristic that can be set to on or off. 

back-up: Copy of a disk or file made for safekeeping, or the creation of the disk or 
file. 

bit: Switch in memory that can be set to on (1) or off (0). Bits are grouped into 
bytes. 

block: Area of disk reserved for a specific use. 

bootstrap: Process of loading an operating system into memory. Bootstrap proce- 
dures vary from system to system. The boot for an operating system must be custom- 
ized for the memory size and hardware environment that the operating system man- 
ages. Typically, the boot is loaded automatically and executed at power up or when 
the computer is reset. Sometimes called a cold start. 
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buffer: Area of memory that temporarily stores data during the transfer of 
information. 

built-in commands: Commands that permanently reside in memory. They respond 
quickly because they are not accessed from a disk. 

byte: Unit of memory or disk storage containing eight bits. 

command: Elements of a CP/M-68K command line. In general, a CP/M-68K com- 
mand has three parts: the command keyword, the command tail, and a carriage 
return. 

command file: Series of coded machine executable instructions stored on disk as a 
program file, invoked in CP/M-68K by typing the command keyword next to the 
system prompt on the console. The CP/M-68K command files generally have a file- 
type of 68K. Files are either command files or data files. Same as a command program. 

command keyword: Name that identifies a CP/M-68K command, usually the pri- 
mary filename of a file of type 68K, or a built-in command. The command keyword 
precedes the command tail and the carriage return in the command line. 

command syntax: Statement that defines the correct way to enter a command. The 
correct structure generally includes the command keyword, the command tail, and a 
carriage return. A syntax line usually contains symbols that you should replace with 
actual values when you enter the command. 

command tail: Part of a command that follows the command keyword in the com- 
mand line. The command tail can include a drive specification, a filename or filetype, 
and options or parameters. Some commands do not require a command tail. 

concatenate: Term that describes one of PIP's operations that copies two or more 
separate files into one new file in the specified sequence. 

console: Primary input/output device. The console consists of a listing device such 
as a screen and a keyboard through which the user communicates with the operating 
system or applications program. 
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control character: Nonprinting character combination that sends a simple com- 
mand to CP/M-68K. Some control characters perform line editing functions. To enter 
a control character, hold down the CONTROL key on your terminal and strike the 
character key specified. See Appendix D. 

cursor: One-character symbol that can appear anywhere on the console screen. The 
cursor indicates the position where the next keystroke at the console will have an 
effect. 

data file: Nonexecutable collection of similar information that generally requires a 
command file to manipulate it. 

default: Currently selected disk drive and user number. Any command that does 
not specify a disk drive or a user number references the default disk drive and user 
number. When CP/M-68K is first invoked, the default disk drive is drive A, and the 
default user number is 0, until changed with the USER command. 

delimiter: Special characters that separate different items in a command line. For 
example, in CP/M-68K, a colon separates the drive specification from the filename. 
A period separates the filename from the filetype. Brackets separate any options from 
their command or file specification. Commas separate one item in an option list from 
another. All of these special characters are delimiters. 

directory: Portion of a disk that contains entries for each file on the disk. In response 
to the DIR command, CP/M-68K displays the filenames stored in the directory. 

DIR attribute: File attribute. A file with the DIR attribute can be displayed by a 
DIR command. 

disk, diskette: Magnetic media used to store information. Programs and data are 
recorded on the disk in the same way that music is recorded on a cassette tape. The 
term diskette refers to smaller capacity removable floppy diskettes. Disk can refer to 
a diskette, a removable cartridge disk or a fixed hard disk. 

disk drive: Peripheral device that reads and writes on hard or floppy disks. 
CP/M-68K assigns a letter to each drive under its control. For example, 
CP/M-68K may refer to the drives in a four-drive system as A, B, C, and D. 
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editor: Utility program that creates and modifies text files. An editor can be used 
for creation of documents or creation of code for computer programs. The 
CP/M-68K editor is invoked by typing the command ED next to the system prompt 
on the console. See ED in Section 6 of this manual. 

executable: Ready to be run by the computer. Executable code is a series of instruc- 
tions that can be carried out by the computer. For example, the computer cannot 
execute names and addresses, but it can execute a program that prints all those 
names and addresses on mailing labels. 

execute a program: Start a program executing. When a program is running, the 
computer is executing a sequence of instructions. 

FCB: File Control Block. 

file: Collection of characters, instructions or data stored on a disk. The user can 
create files on a disk. 

File Control Block: Structure used for accessing files on disk. Contains the drive, 
filename, filetype and other information describing a file to be accessed or created on 
the disk. 

filename: Name assigned to a file. A filename can include a primary filename of 1 
to 8 characters and a filetype of to 3 characters. A period separates the primary 
filename from the filetype. 

file specification: Unique file identifier. A complete CP/M-68K file specification includes 
a disk drive specification followed by a colon (d:), a primary filename of 1 to 8 
characters, a period and a filetype of to 3 characters. For example, b: example.tex 
is a complete CP/M-68K file specification. 

filetype: Extension to a filename. A filetype can be from to 3 characters and must 
be separated from the primary filename by a period. A filetype can tell something 
about the file. Certain programs require that files to be processed have certain file- 
types. See Appendix C. 

floppy disk: Flexible magnetic disk used to store information. Floppy disks come in 
5 1/4 and 8 inch diameters. 

hard disk: Rigid, platter-like, magnetic disk sealed in a container. A hard disk 
stores more information than a floppy disk. 
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hardware: Physical components of a computer. 

hex file: ASCII-printable representation of a command (machine language) file. 

hexadecimal notation: Notation for the base 16 number system using the symbols 
0, 1, 2, 3, 4, 5, 6, 7, 8, 9, A, B, C, D, E, and F to represent the sixteen digits. 
Machine code is often converted to hexadecimal notation because it can be easily 
represented by ASCII characters and therefore printed on the console screen or on 
paper. See Appendix B. 

input: Data going into the computer, usually from an operator typing at the termi- 
nal or by a program reading from the disk. 

interface: Object that allows two independent systems to communicate with each 
other, as an interface between hardware and software in a microcomputer. 

I/O: Abbreviation for input/output. 

keyword: See command keyword. 

kilobyte: 1024 bytes denoted as IK. 32 kilobytes equal 32K. 1024 kilobytes equal 
one megabyte, or over one million bytes. 

list device: Device such as a printer onto which data can be listed or printed. 

logged in: Made known to the operating system, in reference to drives. A drive is 
logged in when it is selected by the user or an executing process, and remains selected 
or logged in until you change disks in a floppy disk drive or enter CTRL-C at the 
command level. 

logical: Representation of something that might or might not be the same in its 
actual physical form. For example, a hard disk can occupy one physical drive, and 
yet you can divide the available storage on it to appear to the user as if it were in 
several different drives. These apparent drives are the logical drives. 

megabyte: Over one million bytes; 1024 kilobytes. See byte, kilobyte. 

microprocessor: Silicon chip that is the Central Processing Unit (CPU) of the 
microcomputer. 
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operating system: Collection of programs that supervises the running of other pro- 
grams and the management of computer resources. An operating system provides an 
orderly input/output environment between the computer and its peripheral devices. It 
enables user-written programs to execute easily. 

option: One of many parameters that can be part of a command tail. Use options 
to specify additional conditions for a command's execution. 

output: Data that the processor sends to the console or disk. 

parameter: Value in the command tail that provides additional information for the 
command. Technically, a parameter is a required element of a command. 

peripheral devices: Devices external to the CPU. For example, terminals, printers 
and disk drives are common peripheral devices that are not part of the processor, 
but are used in conjunction with it. 

physical: Actual hardware of a computer. The physical environment varies from 
computer to computer. 

primary filename: First 8 characters of a filename. The primary filename is a unique 
name that helps the user identify the file contents. A primary filename contains 1 to 
8 characters and can include any letter or number and some special characters. The 
primary filename follows the optional drive specification and precedes the optional 
filetype. 

program: Series of specially coded instructions that performs specific tasks when 
executed by a computer. 

prompt: Any characters displayed on the video screen to help the user decide what 
the next appropriate action is. A system prompt is a special prompt displayed by the 
operating system. The system prompt indicates to the user that the operating system 
is ready to accept input. The CP/M-68K system prompt is an alphabetic character 
followed by an angle bracket. The alphabetic character indicates the default drive. 
Some applications programs have their own special system prompts. 

Read-Only: Attribute that can be assigned to a disk file. Every file and drive is 
either Read-Only or Read- Write. When a file is set to Read-Only, you can read from 
that file but not write any changes to it. The default setting is Read-Write. Any error 
in resetting the disk or changing media automatically sets the drive to Read-Only 
until the error is corrected. 
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Read- Write: Attribute that can be assigned to a disk file. The Read-Write attribute 
allows you to read from and write to a specific Read- Write file so marked. See Read- 
only. 

record: Collection of data. A file consists of one or more records stored on disk. 
An CP/M-68K record is 128 bytes long. 

RO: Abbreviation for Read-Only. 

RW: Abbreviation for Read-Write. 

sector: Portion of a disk track. There are a specified number of sectors on each 
track. 

software: Specially coded programs that transmit machine readable instructions to 
the computer, as opposed to hardware, which is the actual physical components of a 
computer. 

source file: ASCII text file that is an input file for a processing program, such as an 
editor, text formatter, or assembler. 

syntax: Format for entering a given command. 

system attribute: A file attribute. You can give a file the system attribute by using 
the SYS option in the STAT command. A file with the SYS attribute is not displayed 
in response to a DIR command; you must use DIRS to view a directory of files 
having the system attribute. (See Section 5.) 

system prompt: Symbol displayed by the operating system indicating that the sys- 
tem is ready to receive input. See prompt. 

terminal: See console. 

track: Concentric rings dividing a disk. There are 77 tracks on a typical eight-inch 
floppy disk. 

turn-key application: Application designed for the non computer-oriented user. For 
example, a typical turn-key application is designed so that the operator needs only to 
turn on the computer, insert the proper program disk and select the desired proce- 
dure from a selection of functions (menu) displayed on the screen. 
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upward-compatible: Term meaning that a program created for the previously released 
operating system (or compiler, etc.) runs under the newly released version of the 
same operating system. 

user number: Number assigned to files in the disk directory so that different users 
need deal only with their own files and have their own directories even though they 
are all working from the same disk. In CP/M-68K, files can be divided into 16 user 
groups. 

utility: Tool. Program that enables the user to perform certain operations, such as 
copying files, erasing files, and editing files. Utilities are created for the convenience 
of programmers and users. 

wildcard characters: Special characters that match certain specified items. In 
CP/M-68K there are two wildcard characters, ? and *. The ? can be substituted for 
any single character in a filename, and the * can be substituted for the primary 
filename or the filetype or both. By placing wildcard characters in filenames, the user 
creates an ambiguous filename and can quickly reference one or more files. 



End of Appendix E 
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Reader Comment Card 

We welcome your comments and suggestions. They help us provide you with better 
product documentation. 
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3. Did you find errors in this manual? (Specify section and page number.) 



CP/M-68K™ Operating System User's Guide 
Second Edition: June 1983 
1015-2003-002 

COMMENTS AND SUGGESTIONS BECOME THE PROPERTY OF DIGITAL RESEARCH. 



From: 



NO POSTAGE 
NECESSARY 
IF MAILED IN THE 
UNITED STATES 



BUSINESS REPLY MAIL 

FIRST CLASS / PERMIT NO. 182 / PACIFIC GROVE, CA 



POSTAGE WILL BE PAID BY ADDRESSEE 



M DIGITAL RESEARCH* 

Attn: Publications Production 

P.O. BOX 579 

PACIFIC GROVE, CA 93950-9987 



ll.l,...ll,l.l,..l.l.ll...l.l..l.l..l..l.l.., 



1015-200: 



